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Adding a COM Object to the Object Repository 



1 . Select COM Objects in Object Repository > Business Rules Objects. 
Z Click Action j Add Object. 



(Manager opens the COM Object Browser dialog box. 




3. Select an item from the Type Libraries box 

4. Click Browse to find Type Libraries from another computer. 

5. Click Add Type Library, 

6. Select a type library you want to remove and click Remove Type Library. 

7. Select an object from Object Names. 

8. tf the Type Ubrary selected 

name in the Programmatic ID field and clicking Find and then Find Next until object is found. 



Adding a Script to the Object Repository 



1. Click Scripts located in Object Repository > Business Rules Objects. 
Z Click Action j Add Script 




3. Type script name in the Description box. 

4. Select the language of the script 

5. Select the script type in the Category box (Generic or Marshalling). 

6. Type the script code directly in the box, or click Load Script Code button to download a selected script. 

7. Click Verify Script to test your script for errors. 

8. Click OK. 

Additional Topics 

Learn about the Script Editor 



Adding Connections to a Host 



iManager allows the administrator to add or assign connection objects that are listed in the Object Repository to the iManager system 
hosts. This process consists of two-steps: 

1. Adding a connection object to the Object Repository Qf one that you want to use does not already exist), and then 

2. Adding or assigning the connection to a host 
This topic focuses on Step 2. 

To add a connection to a host (easy drag-and-drop operation) 

1. Expand the Hosts folder, and then expand the folder of the host you wish to add a connection to. 

2. Click Connections and drag the connection object in the right pane to the Connections folder of the host 

To add multiple connections to a host 

1. Expand the Hosts folder, and then expand thefoWer of the host you wish to add a connection to. 

2. Right-click Connections, and then click Add Connection. 

-or- 

Click Connections, and then on the Action menu click Add Connection. 

3. in the Add Connections to Host dialog box, select the desired connection Object Name check boxes or click Select AH 

4. Click Import selected to add the selected connections to the host 

Additional Topics: 

Adding Connection Objects 



Adding Users to a Host 



To grant a user 10 access to a user host connection object, the user ID must already exist in the Host Users folder. 
To add a host user (easy drag-and-drop operation) 

1. Expand the Hosts folder, and then expand the folder of the host you wish to add a user to. 

2. Click Users and drag the user object in the right pane to the Host Users folder of the host. 

To add multiple host users 

1. Expand the Hosts folder, and then expand the folder of the host you wish to add a connection to. 
2 Right^lick Host Users, aid then dick Add Users to Host. 

-or- 

Click Host Users, and then on the Action menu dick Add Users to Host 

3. In the Select users for the host dialog box, select the desired host User 10 check boxes or dick Select All 

4. Click Import selected to add the selected user IDs to the host. 

Additional Topics: 

Adding Users to iManager 
Security 



Adding Script Objects 



Marshalling Scripts use script objects. In order to add a script object to a marshalling script, you must first add the object to the 
Object Repository. See Adding a Script to the Object Repository . 



To add Objects to a Marshalling Script 

1 . Select the script in Scripts, located under Business Rules Objects. 



iManager opens the Script's Objects dialog box 




2. Click Add. 

iManager opens the Select an object from the Object Repository Management dialog box 




3. Select the object you want to add to the script and enter a metaname in the Object Name box. The Object Name is the name 
used in the script code referring to this object's instance. 

4. Click OK. 



Repeat the above steps for each additional object 
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Answer Messages 



Message ID 
imDone 



Message 
Number 

$00000000 



Description 

Acknowledge message from the host meaning operation successfully 
completed. 



fm Error 
im Overflow 



$20000000 Included in the reply message ID whenever errors are raised. 

$01010000 The information requested in a one-shot message did not fit Into the 
message buffer. 



imNoData 

imDBError 

imSQLError 



$01020000 A data request returned no data 

$01040000 Error when trying to access a table or query. 

$01 1 00000 The database provider returned an SQL-Error when trying to execute i 
query. Usually caused by syntax errors in the SQL statement 



imUnknownReport 



$01 200000 Trying to execute a dataset related request without opening a dataset 
first. 



ImDataNotFound $02020000 imFind or imFindNext returned an empty page. 

imDatasetOpen $02040000 Trying to open a new dataset before closing the current one. 

imCommError $02080000 General communication error. Communication to the Host has been lost. 



imParamError $02200000 Some of the parameters sent in the request are erroneous. (Example: a 

wrong page number for imGotoPage would generate this error message.) 



imFiteError 


$02400000 


Requested file does not exist. 


imFieldNotFound 


$02800000 


Wrong fieldname for imFind or imFindNext. 


imTransactiofiError 


$04010000 


Transaction rules were violated. 


imllnknownFile 


$04080000 


Requested file not found. 


ImLoginError 


$04200000 


Login/password error at login time. 


i m Recon necti on Error 


$04400000 


Unable to reconnect to the requested host. 


imUnknownMessage 


$40000000 


Message ID unknown. 


im Unknown Error 


$01111111 


Error of unknown cause. 


imLoginSourceError 


$04800000 


Error connecting to an authentication source. 


imDBAccessError 


$08000000 


Unable to assign a dB connection for the user at login time. 


imAdmlnDBError 


$04100000 


Unable to connect to the admin database (i.e. when login) 



Client Objects 



MetiUnx technology provides two different objects to be used by client applications to establish connections to hosts: ioRemote and 
ioCOMRemote. Each of these objects has an API (application programming interface) defined to allow clients to interact with 
Manager hosts and transmit data to and from the database servers. 

ioRemote 

ioRemote is a dynamic fink library (ioRemote.DLL) that implements a set of functions to open a connection to a host, send/receive 
data to/from the host, close the connection and perform miscellaneous taste (like checking connection status). All functions can 
be called using the stdcall calling convention, so it can be used from applications written in Delphi, C++, Visual Basic or Java 

Along with functions, iManager Messages must be used to retrieve aid update data on your n-tier application platform. These 
messages have been designed to allow the most flexibility, scalability and functionality. iManager Messages are further detailed 
in this section. 

ioCOMRemote 

This object is actually an active DLL containing the definition and implementation of MetiUnxClient, a COM-object implementing 
the client functionality. MetiUnxClient COM-interiace is implemented using the iManager messaging system rather than DCOM, 
so it enjoys the same speed and reliability as ioRemote. It is the ideal object for establishing a painless connection between 
web-servers or web applications, and a iManager host 



Client Software Requirements 



♦ Windows NT Workstation 4.0 

♦ Windows 98 
Windows 95 

1 Windows Socket 2 (Winsock) 

2. Diai-Up Networking 1.3 Performance and Security Upgrade Patch 



Closing Connections to a Host 



procedure Disconnect ; safecall 

Description: Closes an existing connection to a host 



Closing Connections to Host 



prodecure CfoseConnection ;stdcall; export; 

Description: Closes an existing connection to host 

Returns: No value. 

Example in PASCAL: 

Try 

CfientlD := LoginEx (pHostName, ServerAddr , pUsername, pPassword, LError, pPort); 

Finally 

CloseConnection; 

End; 

The above example connects to the Host with the function LoginEx After the job is done, it closes 
the connection by calling the procedure CloseConnection, 



Code Sample 



The example included here shows how to use iocoMRemote . dii for executing your remote COM objects and for querying the 
DLO object at the server. The sample also shows how to connect to a host and invoke the DLO methods using a host message. 

Note: 

You need to import all of your COM objects using the IMetiUnx interface. If you wish to obtain a list of data servers for a given 
host, import the DLO object into iManager. 

Dim Obj As Object 

Private Sub Command1_Click() 

Caption = "Connecting..." 

SeiObj = CreateObjertficOxnRer^ 

Call Obj.ConnectCHOSTr, "192.168.2.84", 1024, "usemarnel", "password", "metilinx", status) 
Caption = "Connected to 192.168.2.84" 
End Sub 

Private Sub Command2_Click() 
Dim msgid As Variant 
Dim res As Variant 
Dim res1 As Variant 
Dim command As Variant 
Dim status As Variant 

'executing a COM object that resides in the server side 

msgid = 2147483650* the first message after the last iManager reserved message 

'corresponding to hex number 80000002 
command - "select * from authors" 
Call obj.Execute(msgid, command, res, status) 
LabeH .Caption = "value »» " + res 

msgid = 21 47483651 # the second message after the last iManager reserved message 

'corresponding to hex number 80000003 
command = "HOST1 ;" + "2400380870" 

Call obj.Execute(msgid, command, res, status) to obtain the data servers 
Labell .Caption = "DataServer 1»» " + res(0, 0) + " STATISTICS" + res(0, 1) 
Call obj.E)oacute(msgid + 1 , command, res1, status) to obtain the connection strings 
LabeE.Caption = "ConnStr 1»» ID=" + res 1(0, 0) + ■ CONNSTR=" + res 1(0, 1) 
Set res = Nothing 
Set res1 = Nothing 
End Sub 

Private Sub Canmand3_CBck0 

Set obj = Nothing 

Unload Me 
End Sub 



Private Sub FormJ_oad() 
Caption = "Client using ioCOMRernote.DLL" 
End Sub 

Additional Topics: 

Data Load Object 
ioCOM Remote 



COM (OLE/Automation) Errors 



Start at 0x80000001 (-2147483647). For a complete list of error codes, refer to Microsoft documentation. 

Additional Topics: 

iManaqer errors 



Configuring iManager: Security Information 



Use an existing administrative user login to administrate iManager or create a new user. 

1 . Select the Create New User check box to create a separate administrative account to administrate the iManager database. Be 
sure to enter the Source ID (SID) previously indicated. 

2. Enter a Usemame aid Password, confirm the password, and then click Next 

3. Click Run All to create fiie database. 



/ 

Configuring iManager: Create Connection Object 



Using SQL 7 

If you are using SQL Server 7 as your Database Management System (DBMS), then follow these instructions to create the iManager 
administrative database. 

To create the administrative database 

1 . At the iManager Developer 2.2 Configuration window, select Microsoft SQL Server, then click Next 

2. Click Edit Connection String to create the ADO connection string. 

3. Click the Provider tab, and select Microsoft OLE DB Provider for SQL Server. 

4. Click Next 

5. Click the Connection tab, and select or enter a name in the Server Name box. 

6. Enter a Username (typically, SA> and Password. (Verify the type of security SQL Server uses— Windows NT Only 
(Integrated) or SQL Server and NT.) 

7. Click OK then click OK, again, at the Create Connection Object window. 
Note: 

Do not complete Step 3 of the Connection tab. If you do, you will receive error messages because the administrative database 
does not yet exist 

8. Click OK to test the connection object 

9. Enter the Username and Password you previously indicated. 

1 0. Select the Create New User check box to create a separate administrative account to administrate the iManager database. 

11. Enter a Username and Password, confirm the password, and then click Next 

12. Enter a Name, for example, MetiLinx, for the new iManager administrative database. 

13. Click Run All to create the database. 

Once the installation process builds the administrative database, it is complete. 
Note: 

Do not edit the connection string. The only time the connection string is altered, is when you reinstall the application. When you 
do, a new database crverwrites the previous administrative database. 

Using Oracle 8i 

If you are using Oracle & as your DBMS, then follow these instructions to create the iManager administrative database. 

Configuring iManager to use an Oracle database requires running the iManager Oracle Database Constructor (Mkoradb . exe) at 
the database server to simplify the database creation process. The batch file completes the following processes on the Oracle 
database server 

• Creates and starts an Oracle instance 

• Creates a database associated with the instance 

• Adds the database to the listener file so it can accept client connections 

• Configures the client connection 

To Create the Oracle Database Using Mkoradb.exe 

1. Open a command prompt at the database server. 

2. Type c: or the drive letter where you installed iManager. 

3. Type cd program fi!es\meti!inx\metiHnx enterprise 2.2 or the directory path where you installed IManager. 

4. Type mkoradb DBID DBNAME password to run the batch file where the parameters represent the following usage: 

DBID A four-character database system identifier (SID) (4 character limit) 



• DBNAME The name of the database being created (8 character limit) 

♦ password The password for the Internal (or the first user) of the database. This user is 
granted super user rights 

5. To test the connection, type vaw mtemaUpassword@<lbname at the command prompt. 

Once the database constructor builds the administrative database and you have tested the connection, you may continue with 
configuring iManager. 

Tip; 

Use MTLX as the system (source) identifier and METIUNX as the database name. 

Configuring iManager to Use the Oracle Administrative Database 

1 Return to the iManager installation on the host system. 

2. Select Oracle Si as the administrative database. 

3. Enter the Oracle Connection information: 

• Server Name Name of the new Oracle database 

• SID Source or system ID (use MTLX) 

• Host Name Name of the host on which the database (server) resides 

4. At the Create Connection Object window, click Edit Connection String to create the ADO connection string. 

5. At the Provider tab of the Data Link Properties window, select Microsoft OLE DB Provider for Oracle. 

6. Click Next. 

7. At the Connection tab, select or enter a name in the Server Name (database name) box. 

8. Enter information to logon to the database: Username (use internal) and Password. 

9. Click OK to test the Connection Object. 

10. Enter the same Username and Password to logon to the database. If the test is successful, the MetiLinx Enterprise 2.2 
Configuration window appears. If the test is unsuccessful, verify the Server Name, SID, and Host Name. 

11. Select the Create New User check box to create a separate administrative account to administrate the iManager database. Be 
sure to enter the Source ID (SID) previously indicated. 

12. Enter a Username and Password, confirm the password, and then click Next 

13. Click Run All to create the database 

Once the installation process configures the iManager administrative database, it is complete. 
Note: 

Do not edit the connection string. The only time the connection string is altered, is when you reinstall the application. When you 
do, a new database overwrites the previous administrative database. 



Create Connection Object 



Connection String 
Load Definition from File 

Edit Connection String 



Test Connection String 
Object Name 
Computer Name 



The path specification to OLE DB or ODBC data sources. 

Select if you are specifying a Microsoft Data Link connection, you must load an existing data 
fink CudO file 

Select to specify information about source and destination OLE DB data sources. The 
information includes server names, format and location of the data, and passwords. The 
connection is established by the first task that uses the connection. A data source 
connection can specify information about an ODBC data source when using the Microsoft 
providers. 

Select to test connectivity to the data source. 

The name of the connection string object. 

Select the computer on which the data source resides. 



Create Connection Object 



Creating a Host 



The Host Creation Wizard guides you through the five-step process of creating an iManager host. These process steps are: 
1 Naming the host 

2. Creating the database object 

3. Creating the deployment folder 

4. Establishing the TCP/IP settings 

5. Generating the host 




The Host Creation Wizard 



To access the Host Creation Wizard 

• On the MetiLinx iManager window, right-click Hosts, and then choose Add New Host 

-or- 

On the Action menu, click Add New Host. 



To name the host 

1 . Enter the New Host Name (20 character-alphanumeric- maximum, first character must be a letter). 

2. In the Reconnection Timeout box, type or select a number. 

3. Click Next. 



To create the database connection object 

1 . Click Create Connection Object. 

2. On the Create Connection Object dialog box, type an Object Name, and then click Edit Connection String. 

3. You do not need to type or select a Computer Name. 



4. On the Data Link Properties dialog box, click the Provider tab. 

5. Select the appropriate OLE DB Provider, and then dick Next 

6. If you are setting up a connection to an Oracle database, skip Step 7. 

7. On the Connection tab, type or select a Server Name. 

6. You may click Refresh to update the list of available servers. 

9. Enter a Usemame and Password to long on to the server. (Verify the type of security SQL Serve- uses— Windows NT Only 
{Integrated) or SQL Server and NT.) 

10. Type or select the database you are establishing a connection to. 

11. Click OK then click OK, again, at the Create Connection Object window. 

12. At the Connection Object Parameters dialog box, verity the Provider and choose the Security parameter you would like. 

1 3. After verifying the connection object parameters on the Create Connection Object dialog box, click Create to create and test 
the connection object 

14. Enter a User Name and Password. 

Return to the Host Creation Wizard to create additional database connection objects. 
To add the database connection object 

1 . Select from the list of Available Connection Objects the connection object(s) you wish to add to the Selected Connection 
Objects. 

2. Click Add or Add All. 

3. Click Next. 

To create the deployment folder 

1. Verify the Drive where you installed iManager. 

2. Accept the default file location, C : \Program Files\Met.i Li nx\Me tiloJMc Enterprise 2 . 2\Hosts, and then dick 
Next. 

You may create an alternative folder location. MetiLinx recommends that you accept the default location. 

To establish the TCP/IP settings 

1. Type or select a TCP/IP Port . 

Z Select the IP address of the iManager application server. 

3. All static IP addresses for the server are listed. 

4. Click Next to proceed to the final step in the process. 

To generate the host 

1. Verify the Host Creation Options, and then click Finish. 

2. To change the options, click Previous and proceed with the above steps. 
An iManager Info Message will indicate the successful creation of the host 




Note: 

To enable host logging, you must modify the host 

Additional Topics: 

Modifying a host 
Log Settings 



Data Load Object (DLO) 



DLO is a COM object contained in theDio . exe file supplied with version 2.2, which requires you to develop your own COM 
interface. This object provides information about data servers and connections associated with a host, ft supports user's business 
rules implementation by enabling more dynamic opening of database connections. 

By creating your own interface, you can use me DLO to replicate objects to databases and recover failed database connections. The 
DLO enhances your use of the iManager optimization mechanism by providing a sorted list of connection strings based on 
server-load statistics, ft implements the IQataLoadObiect and IMetiLinx interfaces. 



Data Load Object (DLO) 



OLO is a COM object contained in the Dio . exe file supplied with version 2.2, which requires you to develop your own COM 
interface. This object provides information about data servers aid connections associated with a host. It supports user's business 
rules implement^on by enabling more dynamic opening of database connections. 

By creating your own interface, you can use the DLO to replicate objects to databases and recover failed database connections. The 
DLO enhances your use of the iManager optimization mechanism by providing a sorted list of connection strings based on 
server-load statistics. It implements the IDataLoadObiect and IMetiLinx interfaces. 



Data Messages 



j ID ImGetSQLData 
Message Number $00000210 

Explanation This message performs the query requested like SELECT and keeps an open dataset for further 

requests. It also sends the first page of the data result set. 

Required Payload Number of lines per page and the query statement to be performed. Both these parameters 

should be separated by CRLR 



Payload Return 



The first page of the data result set with each field separated by TAB and each line or record 
separated by CRLF. Records per page might be adjusted to avoid page overflow. 



Code Example 

(PASCAL) 



Result 

Function Word 



BufferStr := '20' + #13#10 + 'SELECT * FROM Userinfo' + #13#10 
StrPCopy( Buffer , BufferStr); 
MsglD:= imGetSQLData 
SendMsg(MsglD f ClientiD, Buffer); 

The above example returns the first page with 20 lines or records of the information in the Userlnfo 
table and keeps an open dataset with all the pages of the query result 

SendMsg 



Message ID imFirstPage 
Message Number $00000220 

Explanation This message is used to get the first page of the SQL query result dataset. This message can 

be used only after the message imGetSQLData is sent which keeps track of all the pages of the 
result set. 

Required Payload No value. 

Payload Return First page of the query result dataset with each field separated by TAB and each record 

separated by CRLF. 



Code Example 
(PASCAL) 



StrCopy(Buffer,#0); 

MsglD:= imFirstPage 

SendMsg (MsgID, ClientiD, Buffer); 



Result 

Function Word 



The above example gets the first page of the data result set of the performed query. 



SendMsg 



Documentation Key for Code Samples 



ClientID: The unique identifier for the client, which is returned by the login function. 

HostName: Nui! terminated string containing the Name of the Host as defined in iManager (in all caps). 

LoginError: Null terminated string that will be returned in case of error. Space for resulting string should be 

reserved by the client application. 

Msg: Null terminated string containing the message data sent or received. 

MsglD The message identifier sent when an action is requested from the Host After executing the action, 

the host wfll return a different MsglD indicating the resulting status. 

OLEResult: Variant containing retrieved data 

Password: Null terminated string containing the client's Password. Part of the user credentials. 

Port Port number used to establish the initial connection between Host and client. 

ServerAddn Null terminated string containing the IP address of the Host or the Name of the Server. 

Size: Size of data returned in the "Msg" parameter. 

SourcelD: Null terminated string containing the client's SourcelD. Part of the user credentials. NIL (NULL 
pointer) means DEFAULT (proprietary source). 



UserName: 



Null terminated string containing the client's User Name. Part of the user credentials. 



Deleting a Connection Object 



1 . At the MetiLinx tree, click Object Repository ; then click Connection Objects. 

2. In the right pane, right-click the Connection Object you wish to delete; then dick Delete Connection Object. 

3. In the IManager Message dialog box, click OK to confirm the deletion. 



Deleting a Script 



Delete a script from the Ofcgect Repository if it is no longer in use. 

1 . Click Scripts located in Object Repository > Business Rules Objects. 

2. Select the script you want to delete. 

3. Click Action | Delete Script 



The IManager Message confirmation below appears. 




4. At the iManager message, click OK to complete the deletion . 



Deleting an Object 



Deteiean object from the Object Repository if it is no longer in use. 



0 
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1. Click COM Objects located In Object Repository > Business Rules 

2. Click the object you want to delete. 

3. aide Action ( Delete Object 



The Manager Message confirmation below appears. 




in 



4. Click OK in the iManager message dialog box, confirm the object deletion. 



Contents of the Deployment Folder 



Each Host deployment folder contains the subdirectories and files described in the table below. 



Directory 
BIN 



UPDATE 



File(s) 

iEventexe 

ih<HOSTNAME>.bin 
Empty 



Description 

This executable applies the events and changes to the Host settings. 

These are the configuration files for your Host system as set in 
iManager and are the supporting executable files for this Host. 

This directory is where downloadable fifes for client applications are 
placed. The irnGetFile message is used to accomplish this through 
your client application. This message and its use are explained later 
in the Messages section of this document. 



Note 

The contents in the BIN folder should not be moved or modified under any circumstances. 



To Install MetiLinx iManager Developer 2.2 



1 . Close all programs, including viais-checking programs. 

2. On the Start menu, select Run. 

3. Click Browse to locate your Download folder. 

4. Type or select the file name metiKnxenterprise2 ,2.exe, and then click Open to run the file. 

5. Follow the instructions of the InstallShieki Wizard. 

• Choose Destination Folder 

By default, iManager 2.2 is installed in C:\Program Files\MetiUnx^letiUnx Enterprise 2.2. 

• Select Program Folder 

By default, the program folder is MetiLinx Enterprise 2.2. 

Note: 

You must have full Administrator rights to the local machine. 
You are now ready to create the iManager administrative database. 



Additional Topics: 

To create the iManager administrative database using SQL Server 7 



To create the iManager administrative database using Oracle 8i 



Data Load Object (DLO) 



DLO is a COM object contained in the dio . exe file supplied with version 2.2, which requires you to develop your own COM 
interface. This object provides information about data servers and connections associated with a host It supports users business 
rules implernerrtation by enabling more dynamic opening of database connections. 

By creating your own interface, you can use the DLO to replicate objects to databases and recover failed database connections. The 
DLO enhances your use of the iManager optimization mechanism by providing a sorted list of connection strings based on 
server-load statistics, ft implements the IDataLoadObiect and IMetilinx interfaces. 



Data Load Object (DLO) 



DLO is a COM object contained in the Dio . ex© file supplied with version 2.2, which requires you to develop your own COM 
interface. This object provides information about data servers and connections associated with a host. It supports user's business 
rules implementation by enabling more dynamic opening of database connections. 

By creating your own interface, you can use the DLO to replicate objects to databases and recover failed database connections. The 
DLO enhances your use of the iManager optinrazation mechanism by providing a sorted list of connection strings based on 
server-load statistics. It implements the IDataLoadObiect and IMetiLinx interfaces. 



Documentation Key for Request Messages 



J ID 

Message Number 
Explanation 
Required Payfoad 
Payload Return 
Code Example 
Result 

Function Wad 



Message Name 

Message Number used in the Longlnt portion of the message. 

Description of the use of the message. 

The payload required in the message. 

The payload or value returned by the Host, if any. 

An example of how this message would be used in coding language. 

Shows the result yxxj would expect from the Code example above. 

Name of the function used to send this message ID. 



What's New with MetiLinx iManager Developer 2.2 



MetiLinx Enterprise 2.1 has branched out to Metilinx iManager Developer 2.2 (iManager) and MetiLinx iSystem Enterprise 2.2 
(iSystem). iManager is a development tool that ads developers in building e-business systems. These systems subsequently inherit 
the MetiLinx optimization technology. This release of iManager delivers a broad range of object support and management in an open 
environment 

S Dual interface support for scripting languages 

MetiLinx iManager Developer 2.2 supports the IDispatch interface to enable developers working in 
scripting languages, such as VBScript and JScript, to access the iManager Repository components. 

S New! Script Editor 

The new Script Editor offers basic editing support, enabling developers to edit code from generic and 
marshalling scripts. 

V Enhanced remote COM management 

With MetiLinx iManager Developer 2.2, MetiLinx continues to build and expand upon the remote COM 
management functionality and open environment of MetiLinx Enterprise 2.1 Enhanced features include: 

• improved object streaming 

o Enables remote object handling without the need to register the client 

o Promotes code efficiency 

o Supports local and remote calling on client 

• Object repository management 

• Access to host-level information, such as, connection objects, repository objects, and user 
connections. 



Easy Steps to [Manager Implementation 



1. Create Hosts with the Create Hosts Wizard 

2. Create Connection Objects in the Object Repository 

3. Create Global Users 
A Add Users to Hosts 

5- Add Connections to Hosts 

6. Add User Access to Connections 

7. Implement Business Rules 

. Add COM Objects to the Object Repository 
• Add Scripts to fiie Object Repository 

8. Establish Universal Settings 



Additional Topics: 

installing iManager 



COM (OLE/Automation) Errors 



Start at 0x80000001 (-2147483647). For a complete list of error codes, refer to Microsoft documentation. 

Additional Topics: 

[Manager errors 



Establishing Log Settings 

By default, the host log is not activated during the creation of a host Administrators, therefore, must manually activate logging, and 
then configure the Log viewer for each host to filter log the desired information. 

To activate a host log 

1. Click the Host folder to view the list of hosts. 

2. Right-click the host you wish to active logging on, and then click Modify Host. 

3. Click Log Settings and select the Enable Log check box 

4. Select the desired option settings. 

To configure the log viewer 

1. Click the Host folder to view the list of hosts. 

2. Right-click the host you wish to active logging on, and then click Modify Host 

3. Click Log Viewer Settings and select the desired option settings. 



Establishing Universal Log Settings 



Use the Settings module to modify Agent Refresh Time, Log Refresh Time, Log View Entries, and Screen Refresh Time for Hosts. 

1 . Click Settings, then right-click the setting you want to modify. 

2. Click Modify Settings . 

3. Enter the parameter values you want to use. 
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Firewall Settings 



Client application processes may cross a firewall to access an iManager host When you create an iManager host, you must assign 
it a port number to enable access to the host through a firewall. 



By default, the iManager host configuration process initially uses connection port 1024 for the first established iManager host Once 
connectivity is established and security access authorized, the host hands off the session to an available socket then continues to 
listen for port 1024 session requests. 



For each additional host you create with iManager, you must assign a different port number. These port assignments enable 
subsequent hosts to receive session requests. 

Note: 

Set up port 1024 and subsequent ports to use the same rules applied to the HTTP connection port 80 on your firewall. Use ports 
1025 through 5000 with the exceptions of ports 3012 and 4012. iManager reserves these ports for the TLO and SLO components. 



Hardware Requirements 



• 300 MHz Pentium™ li processor 

• 120 MB RAM or more 

• 100 MB free disk space 
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Host Creation Wizard: Database Connections 



To create the database connection object 

1 . Click Create Connection Object 

2. On the Create Connection Object dialog box, type an Object Name, and then click Edit Connection String. 

3. You do not need to type or select a Computer Name. 

4. On the Data Link Properties dialog box, click the Provider tab. 

5. Select the appropriate OLE DB Provider, and then click Next 

6. if you are setting up a connection to an Oracle database, skip Step 7. 

7. On the Connection tab, type or select a Server Name. 

8. You may click Refresh to update the list of available servers. 

9. Enter a Username and Password to long on to the server. (Verify the type of security SQL Server uses— Windows NT Only 
(integrated) or SQL Server and NT.) 

10. Type or select the database you are establishing a connection to. 

11. Click OK then click OK, again, at the Create Connection Object window. 

12. At the Connection Object Parameters dialog box, verify the Provider and choose the Security parameter you would like. 

1 3. After verifying the connection object parameters on the Create Connection Object dialog box, click Create to create and test 
the connection object 

14. Enter a User Name and Password. 

Return to the Host Creation Wizard to create additional database connection objects. 
To add the database connection object 

1 . Select from the list of Available Connection Objects the connection object(s) you wish to add to the Selected Connection 
Objects. 

2. Click Add or Add All. 

3. Click Next. 



Host Creation Wizard: Deployment Folder 



To create the deployment folder 

1. Verify the Drive where you installed iManager. 

2. Accept the default fife location, C : \Program Fil«s\MetiLinx\MetiLinx Enterprise 2 . 2\Hosts, and then Click 
Next 

You may create an alternative folder location. MetiLinx recommends that you accept the default location. 
Contents of the host deployment folder 

Each Host deployment folder contains the subdirectories and files described in the table below. 

Directory Flle(s) Description 

BIN iEventexe This executable applies the events and changes to the Host settings. 

ih<HOSTNAME>. bin These are the configuration files for your Host system as set in 
iManager and are the supporting executable files for mis Host 

UPDATE Empty This directory is where downloadable files for client applications are 

placed. TheimGetFile message is used to accomplish this through 
your client application. This message and its use are explained later 
in the Messages section of this document. 

Note 

The contents in the BIN folder should not be moved or modified under any circumstances. 



Host Creation Wizard: Name for New Host 



To name the host 

1 Enter the New Host Name. 

2. In the Reconnection Timeout box, type or select a number. 

3. Click Next. 



Host Creation Wizard: Start Generation 



To generate the host 

1 . Verify the Host Creation Options, and then dick Finish. 

2. To change the options, click Previous and proceed with the above steps. 



An iManager Info Message will indicate the successful creation of the host 




Host Creation Wizard: TCP/IP Settings 



To establish the TCP/IP settings 
1 Type or select a TCP/IP Port . 

2. Select the IP address of the iManager application server. 

3. All static IP addresses for the server are listed. 

4. Click Next to proceed to the final step In the process. 



Host Objects 



After successfully executing the Host Setup Wizard, a complete host system is created. Two objects are a part of this new system: 
ioHost and iEvent Since there is no direct user interaction with these objects, no interface description is provided. Settings for both 
objects are modified through iManager and data is requested through remote connections. 

ioHost 

The ioHost Object instantly creates a complete host system on your server based on the parameters you select during the iManager 
Host creation process. The ioHost Object works with the ioRemote Object to create your custom application Object 

iEvent 

The iEvent Object is in charge of logging host events and communications with iManager. This object intelligently gathers these 
events so it does not impede the performance between your client and Host applicatois. 



The Object Repository 



The Saf' Object Repository is the module that provides COM object management. It includes functionality for registering, adding, 
removing and modifying objects. It also allows interface verification and instantiation, as a warranty of object availability. 



iManager messages are pre-structured messages, functions and procedures that simplify the programming of your client 
application. They have been specifically designed for flexibility, scalability, and purpose. The built-in messaging protocol allows 
developers to extend iManager COM object capabilities with custom messages to interact with existing objects. iManager separates 

COMObjects into two categories: ^fe* Connection Objects and ^Sfl Business Rules Objects 

Connection objects are solely used by the host system to establish connections to database servers using ODBC and OLE 
DB-connections. 

Business Rules Objects refers to objects created outside of iManager and which will be accessed through the COM-metaphor. For 
these objects to be accessible from iManager, they must implement the IMetHJnx interface or use a marshalling script compliant with 
iManager specifications. 

To use COM-objects, developers create new message IDs and associate them with actions and objects. These message IDs and 

associations are global for iManager and are stored in the IS Object Repository. At the User's option, iManager can verify the 
integrity of object definitions by checking its presence and interface implementation. 

There are three ways COM-objects can be used by a Host 

1 . Direct access to COM-objects implementing IMetiLinx interface. 

2. Access through a Marshalling Script to generic COM-objects kept in the repository. 

3. Execution of a Generic Script kept in the^ Object Repository. 



Prototype of the interface IDataLoadObject 



procedure getDataServers 



( const Host 
ClientID 

out DataServerlist 



WkteString; 
OleVariant; 
OleVariant); safecall; 



procedure getConnStrings 



(const Host 

ClientID 

outConnStriist 



WkteString; 
OleVariant; 
OleVariant); safecall; 



procedure ctoseADOconn ( ConnID 



: OleVariant); safecall; 



procedure openADOconn 



(ConnID 

outConnADO 

ConnOpenedID 



OleVariant; 
OleVariant; 
OleVariant); 



: LongWord; //= 1 (to pull the data servers list) 

: WkteString; // = <Host name>;<ClientlD> 

Example: CmdStr = 'Hostl; 1277608648' 

OleVariant; 

OleVariant); safecall //A two dimensional array with the data 
servers information 

Description: This additional object also implements the interface IMetilinx, which is accessible through the function. 
ProcessCommand 



ProcessCommand ( CmdID 

const CmdStr 

Cmdlnfo 

var CmdResuft 



( CmdID 
const CmdStr 
Cmdlnfo 
var CmdResuft 



// = 2 (to pull the connection string list) 
// = <Host name>;<ClientlD> 

// 



LongWord; 
WkteString; 
OleVariant; 

OleVariant); safecall // A two dimensional array with the data 
servers information 

Description: This additional object also implements the interface IMetilinx, which is accessible through the function. 



ProcessCommand ( CmdID 



: LongWord; 



//= 3 (to open an ADO connection using a 
connection ID) 

//<ConnectionlD> 



const CmdStr : WkteString; 
Cmdlnfo : OleVariant; 

var CmdResuft : OleVariant); // A two dimensional array containing the 

safecall; ADO connection object and a 

connectten-opened-ID. 

Description: This additional object also implements the interface IMetilinx, which is accessible through the function. 



ProcessCommand 



{ CmdID 
const CmdStr 
Cmdlnfo 
var CmdResuft 



LongWord; 

WkteString; 

OleVariant; 

OleVariant); 
safecall; 



// = 4 (close a currently open connection) 
// = <ConnectionOpenedlD> 

// 

// = No values returned 



Description: This additional object also implements the interface IMetilinx, which is accessible through the function. 
Note: 

Please observe the parameter differences when using different CmdIO values. 



Data Load Object (DLO) 



DLO is a COM object contained in the Dio.exe file supplied with version 2.2, which requires you to develop your own COM 
interface. This object provides information about data servers and connections associated with a host, it supports user's business 
rules implementation by enabling more dynamic opening of database connections. 

By creating your own interface, you can use the DLO to replicate objects to databases and recover fated database connections. The 
DLO enhances your use of the iManager optimization mechanism by providing a sorted list of connection strings based on 
server-load statistics, it implements the IDataLoadObject and IMetiLinx interfaces. 



Configuring iManager: Create Administrative Database 



In this step, iManager builds the administrative database for Microsoft SQL 7. 



1. In the Database Name field, enter a database name to create. 

Note: Do not check the boxes in the Create Database field. They will be completed automatically. 

2. Click Next 

3. Click Yes when prompted to create database scripts. 



The InstallShietd Wizard will indicate that the iManager installation is complete Before you can use the program, you must restart 
your computer. 
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iManager Errors 



The Status parameter of the ioCOMRemote functions returns the following errors: 



Code 


Error 


0 


Noenror. 


-20000 


Unexpected error. 


-20001 


Error getting data from the Host 


-20002 


Error writing to stream. 


-20003 


Error reading from stream. 


-20004 


Equivalent Hosts not found. 


-20005 


Host not found. 


-20006 


Error sending message. 


-20007 


Error in parameters. 


-20008 


Reconnection error. 


-20009 


Host name error. 


-20010 


Error accessing administrative database. 


-20011 


Database server error. 


-20012 


Usemame/Password error. 


-20013 


Error Connecting to Host 


-20014 


Server name/Port incorrect. 


-20015 


Error Connecting to TLO. 


-20016 


Error looking tor equivalent hosts. 


-20017 


Error in function Execute. 


-20018 


Interna! error sending message- 


-20019 


Object not registered repository. 


-20020 


Object not in table. 


-20021 


Object not in remote table. 


,-20022 


Interface not registered locally. 


-30001 


Error invoking object function. 


-30002 


Error getting memory for Dispatch Parameters structure. 


-30003 


Error freeing memory for Dispatch Parameters structure. 


-30004 


Error getting Parameter List. 


-30005 


Variant array has no dimensions. 


-30006 


Invalid Function Name. 


-30007 


Error setting the Parameter list 


-30008 


Invalid variant type conversion getting parameters. 


-30009 


Invalid variant type conversion setting parameters. 


-30010 


Error creating IProvideCiasslnfo interface. 


-30011 


Error in IDispatch interface. 


-30012 


Error getting function description. 


-30013 


Error freeing function description. 


-30014 


Function description is empty. 


-30015 


Invalid Parameter List. 


-30016 


Invalid interface Name. 


-30017 


Error trying to execute IDispatch.lnvoke. 


-30018 


Error Saving IPersistStream. 



-30019 


Error getting ITypelnfo instance of the library. 


-30020 


Error streaming object 


-30021 


Error saving variant to stream. 


-30022 


Error saving object properties. 


-30023 


Error loading variant from stream. 


-30024 


Error loading the variant from a IPersistSiream. 


-30025 


Stream kind not allowed. 


-30026 


Error loading from stream. 


-30027 


Error saving stream to variant 


-30028 


Error filling the Dispatch Parameters structure. 


-30029 


Error verifying the object in Repository. 


-30030 


Error getting the list of imptemented interfaces from IDispatch. 


-30031 


Error getting the list of imptemented interfaces from Classlnfo. 


-30032 


Error getting the ITypeLib interface. 


-30033 


Error in InvokeDotNotation function. 


-30034 


Error in SearchfnterfaceName function. 


-30035 


Error in dot Notation. 


-30036 


Error getting ITypeLib interface of the object. 


-30037 


Error filling the Parameters list to pass ft to invoke function. 


-30038 


Error filling the Named Argument list to pass it to invoke function. 


-30039 


Error in SaveCollecttonToArray function. 


-30040 


Error in SaveAirayToCollecrjon function. 


-30041 


Error in SaveDispatchObj function. 


-30042 


Error in Create function of TObjPerformer. 


-30043 


Error in GetfrrterfaceUst function. 


-30044 


Error in GetMemberList function. 


-30045 


Error in GetParameterList function. 


-30046 


Error in SaveRecordSet function. 


-30047 


Error in LoadRecordSet function. 



Additional Topics: 

COM (OLE/Automation) Errors 



iManager Toolbar Buttons 



Button Command 
Add 

31 Add New User/External Source 

S| Delete/Remove 

Ml Bat/ Close 

ftj Filter 

£ ModHy 

III Run Host 

ft Stop Host 

91 Verify 

m vfewAH 

& Object/Script Messages 

Sfe Script Objects 



iManager Window 




Additional Topics: 

Leam about the Object Repository 



Prototype of the interface IDataLoadObject 



procedure getDataServers 



{const Host 
ClientID 

out DataServerList 



WideString; 
OleVariant; 
OieVariant); safecall; 



procedure getConnStrings ( const Host 
Client© 
out ConnStrList 



WideString; 
OleVariant; 
OleVariant); 



procedure closeADOconn { ConnlD 



: OleVariant); safecall; 



procedure openADOconn ( ConnIO 

outConnADO 
ConnOpenedID 



OleVariant; 
OleVariant; 
OleVariant); 



ProcessCommand { CmdlD : LongWord; 

const CmdStr : WideString; 

Cmdlnfo : OleVariant; 
varCmdResuft 



//= 1 {to pull the data servers list) 
// = <Host name>;<ClientlD> 
Example: CmdStr = 'Hostl ;1 277608648' 



OleVariant); safecall //A two dimensional array with the data 
servers information 

Description: This additional object also implements the interface IMetiiinx, which is accessible through the function. 
ProcessCommand 



( CmdlD 
const CmdStr 
Cmdlnfo 
varCmdResult 



// = 2 {to pull the connection string list) 
// = <Host name>;<ClientiD> 
// 



LongWord; 
WideString; 
OleVariant; 

OleVariant); safecall // A two dimensional array with the data 
servers information 

Description: This additional object also implements the interface IMetiiinx, which is accessible through the function. 



ProcessCommand { CmdlD : LongWord; 

const CmdStr : WideString; 

Cmdlnfo : OleVariant; 

war CmdResult : OleVariant); 



II -Z (to open an ADO connection using i 
connection ID) 

//<ConnecfionlD> 



// A two dimensional array containing the 
ADO connection object and a 
connecticrvopened-ID. 

Description: This additional object also implements the interface IMetiiinx, which is accessible through the function. 



ProcessCommand 



{ CmdlD 
const CmdStr 
Cmdlnfo 
varCmdResult 



LongWord; 

WideString; 

OleVariant; 

OleVariant); 
safecali; 



// = 4 {close a currently open connection) 
// = <CairtectionOpenediD> 

// 

// = No values returned 



Description: This additional object also implements the interface IMetilinx, which is accessible through the function. 
Note: 

Please observe the parameter differences when using different CmdIO values. 



IMetilinx Interface 



Below are the interface specifications for the COM object IMetiLiroc Also included is the ProcessComrnand function needed for 
Marshalling Scripts and Generic Scripts. 



// 

// interface: IMetilinx 

// Rags: (320) Duai OleAutomation 

// GUID: {D1 FACAFC-C509-1 1 D3-8775-0050046EDE1 6} 

// 

IMetilinx = interface(IUnknown) 

r{D1FACAFC^509-11D3^77M)05(X)46EDE16n procedure ProcessCommajKl(CrndlD: LongWord; 

const CmdStr WkJeString; 

Cmdinfo: CHeVariant; var CmdResult: 
OteVariant); safecall; end; 

// 



Function Prc<^sCc)rnmand(CmdlO, CmdStr, Cmdinfo) 

CmdfO, CmdStr and Cmdinfo are Variants 

// 

Additional Topics: 

Data Load Object (OLO) 
Publishing Host Information 



Data Load Object (DLO) 



DLO is a COM object contained in Hie Dio . axe file supplied with version 2.2, which requires you to develop your own COM 
interface. This object provides information about data servers and connections associated with a host. It supports user's business 
rules implementation by enabling more dynamic opening of database connections. 

8y creating your own interface, you can use the DLO to replicate objects to databases and recover failed database connections. The 
DLO enhances your use of the iManager optimization mechanism by providing a sorted list of connection strings based on 
server-load statistics, ft implements the IDataLoadObiect and IMetiLinx interfaces. 



Data Load Object (DLO) 



DLO is a COM object contained in the dio . exe file supplied with version 2.2, which requires you to develop your own COM 
interface. This object provides information about data servers and connections associated with a host It supports user's business 
rules implementation by enabling more dynamic opening of database connections. 

By creating your own interface, you can use the DLO to replicate objects to databases and recover failed database connections. The 
DLO enhances your use of the iMartager optimization mechanism by providing a sorted list of connection strings based on 
server-load statistics. It implements the IDataLoadObject and IMetiLinx interfaces. 



Information Messages 



Message ID imGetSQLInfo 
Message Number $00000101 

Explanation This message is used to perform a standard SQL query like SELECT, to get a small amount of 

data from a dataset 



Required Payload SQL query statement 

Payfoad Return The data requested with each field separated by TAB and each record separated by carriage 

return + line feed (CRLF). 



Code Example 
(PASCAL) 



BufferStr := 'Select GetDateff; 
StrPCopy( Buffer , BufferStr ); 
MsgID:= imGetSQUnfo; 
SendMsg (MsglO, ClientID, Buffer); 

CurrentDT := StrToOateTime(Copy(Buffer J 1, Pos(#9,Buffer) -1)); 



Result 

Function Word 



The above example returns the date and time value on the server. ClientID is the value returned 
by the Login function. 

SendMsg 



HD 

Message Number 
Explanation 
Required Payload 



imGetStoredProcedure 
$00000102 

This message calls a stored procedure that returns a dataset. 

Name of the stored procedure and the parameters required by the stored procedure. All of the 
information should be separated by CRLF. 



Payload Return 



The result data returned by the stored procedure with each field separated by TAB and each 
record separated by CRLF. 



Code Example 
(PASCAL) 



BufferStr := StoredProcedureName + #13#10 + spParameterl + #13#10 + spParameter2... 

StrPCopy ( Buffer , BufferStr); 
MsglD:=irnGetStoredProcedure; 
SendMsg ( MsgID , ClientID , Buffer ); 



Result The example will call "StoredProcedureName" with parameters "spParameterl" and 

"spParameter2" and retrieves the result data returned by the stored procedure in the "Buffer," 
with each field separated by TAB and each record separated by CRLF. 

Function Word SendMsg 



imExecStoredProcedure 
$00000103 

This message calls a stored procedure that does not return a dataset 

Name of the stored procedure and the parameters required by the stored procedure. All of this 



HO 

Message Number 
Explanation 
Required Payload 



information should be separated by CRLF. 



Payload Return 



A list of returning parameters with each field separated by TAB and ending in CRLF. 



Code Example 
(PASCAL) 



BufferStr := StoredProcedureName + #13#10 + spParameterl + #13#10 + spPararneterZ. 

StrPCopy ( Buffer , BufferStr ); 
MsglD:=imExecStoredProcedure; 
SendMsg { MsgID , ClientID , Buffer ); 



Result 



The example will call "StoredProcedureName" with parameters "spParameterT and 
"spParameterl and retrieves the result data returned by the stored procedure in the "Buffer," 
with each field separated by TAB and each record separated by CRLF. 



Function Word 



SendMsg 



Message ID ImGetFile 
Message Number $00000104 

Explanation This message transfers files specified by the Host application from the Update directory on the 

Host server to the client PC. 



Required Payload Origin Filename to be transferred from the Host as well as the destination path and Filename. 

The source and the destination values should be separated by a CRLF. The destination path 
must be valid for the local client machine. 



Payload Return 

Code Example 
(PASCAL) 



No return value. 

BufferStr := <Readme.txt' + #13#10 + <C:\mydir\Readnre.txt'; 
StrPCopy(Buffer, BufferStr); 
MsglD:=imGetFiie; 
SendMsg(MsglD f ClientID, Buffer) ; 



tesuit 



The above example will transfer file "Readme.txf ' from the Update Directory on the Host server to 
the clients' local machine in the folder "c:\mydir. ClientID is the value returned by the Login 
function. 



Function Word 



SendMsg 



} ID imGetFileDetails 

Message Number $00000110 

Explanation This message is used to get tire name, size and date stamp of the fite(s) in the Update directory 

of the Host system. This Update directory is created during the creation of the Host system and 
is located i n the deptoyment folder of the Host s ystem you are worki ng with . 



Required Payload No value required 

Payload Return The corresponding information for all existing files in the Update folder Data values for a single 

file are TAB-separated. TAB and CRLF separate entries for different files. 

(Filename#9Rfestzein bytes#8Fitedate#9Fi letime#9#1 3#1 0) 



Code Example 
(PASCAL) 



StrPCopyt Buffer, #0); 
MsglD:^rnGetFileDetails; 
SendMsg (MsgID, ClientID, Buffer); 



Result 



In the above example, the buffer will contain all information for the file, in the specified directory, 
on the server, in the format explained above. CfientID is the value returned by the Login function. 



Function Word 



SendMsg 



Message ID imGetBinarylnfo 
Message Number $00000120 

Explanation This message is used to retrieve query results like SELECT in binary format It is especially 

useful to get Blobs and image fields. 

Required Payload SQL query statement 

Payioad Return Pointer to a buffer containing the query result in binary format and the size of the returned buffer 

in bytes. 



Code Example 
(PASCAL) 



BufferStr := 'Select BMP From Animals Where Name = "Boa"'; 

StrPCopyt Buffer , BufferStr ); 

BufferSize:=strLen(Buffer); 

MsglO:=imGetBinarylnfo; 

SendMsgB( MsgID , ClientiD , Buffer .BufferSize); 



Result 



The above example will get a blob field from the table "Animals". The size of the blob is returned 
in «BufferSize\ 



Function Word 



SendMsgB 



Information Messages 



Message ID ImGetSQLInfo 
Message Number $00000101 

Explanation This message is used to perform a standard SQL query like SELECT, to get a small amount of 

data from a dataset 



Required Payioad SQL query statement 

Payload Return The data requested with each field separated by TAB and each record separated by carriage 

return + line feed (CRLF). 



Code Example 

(PASCAL) 



BufferStr := 'Select GetDateO'; 
StrPCopy( Buffer , BufferStr ); 
MsglD:=imGetSQUrrfo; 
SendMsg (MsgID, CllentlD, Buffer); 

CurrentDT := StrToDateTim^CopytBuffer, 1 , Pos(#9,Buffer) -1)); 



Result 

Function Word 



The above example returns the date and time value on the server. ClientID is the value returned 
by the Login function. 

SendMsg 



>ID 

Message Number 
Explanation 
Required Payload 



imGetStoredProcedure 

$00000102 

This message calls a stored procedure that returns a dataset. 

Name of me stored procedure and the parameters required by the stored procedure. Ail of this 
information should be separated by CRLF. 



Payload Return 



The result data returned by the stored procedure with each field separated by TAB and each 
record separated by CRLF. 



Code Example 
(PASCAL) 



BufferStr StoredProcedureName + #13#10 + spParameterl +#13#10 + spParameterZ 

StrPCopy ( Buffer , BufferStr ); 
MsglD:=HmGetStoredProcedure; 
SendMsg ( MsgID , ClientID , Buffer ); 



Result 



The example will call "StoredProcedureName*' with parameters "spParameterl " and 
• , spParameter2 M and retrieves the result data returned by the stored procedure in the "Buffer" 
with each field separated by TAB and each record separated by CRLF. 



Function Word 



SendMsg 



i ID imExecStoredProcedure 
Message Number $00000103 

Explanation This message calls a stored procedure that does not return a dataset. 

Required Payload Name of the stored procedure and the parameters required by the stored procedure. All of this 

information should be separated by CRLF. 



Payload Return 



Code Example 
(PASCAL) 



A list of returning parameters with each field separated by TAB and ending in CRLF. 

BufferStr := StoredProcedureName + #13#10 + spParameterl + #13#10 + spPararneter2.. 

StrPCopy ( Buffer , BufferStr ) ; 
MsgID:=imExecStoredProcedure; 
SendMsg ( MsglO , ClientID , Buffer ); 



Result 



Function Word 



The example will call "StoredProcedureNarne" with parameters "spParameterl H and 
tt spParameter2 n and retrieves the result data returned fay the stored procedure in the "Buffer," 
with each fiekJ separated by TAB and each record separated by CRLF. 

SendMsg 



Message ID imGetFile 
Message Number $00000104 

Explanation This message transfers files specified by the Host application from the Update directory on the 

Host server to the client PC. 

Required Payload Origin Filename to be transferred from the Host, as well as the destination path and Filename. 

The source and the destination values should be separated by a CRLF. The destination path 
must be valid for the local client machine. 



Payload Return 

Code Example 
(PASCAL) 



No return value. 

BufferStr := 'Readme.txr +#13#10 + 'C:\mydir\Readmatxr; 
StrPCopy(Buffer f BufferStr); 
MsglD:=imGetFile; 
SendMsg(MsglD, ClientID, Buffer) ; 



Result 



The above example will transfer file "Readmatxt" from the Update Directory on the Host server to 
the cfients* local machine in the folder "c:\mydir". ClientID is the value returned by the Login 
function. 



Function Word 



SendMsg 



j ID 

Message Number 
Explanation 



imGetFiteDetails 
$00000110 

This message is used to get the name, size and date stamp of the fite(s) in the Update directory 
of the Host system. This Update directory is created during the creation of the Host system and 
is located in the deployment folder of the Host system you are working wiih- 



Required Payload No value required 

Payload Return The corresponding information fa all existing files in the Update folder Data values for a single 

file are TAB-separated. TAB and CRLF separate entries for different fifes. 

(niename#9Friesizein bytes#9Rledate#9Filetime#9#1 3#1 0) 



Code Example 
(PASCAL) 



StrPCopyt Buffer, #0); 
MsglD:=imGetRleDetails; 
SendMsg (MsgID, ClientID, Buffer); 



Result 



In the above example, the buffer will contain all information for the file, in the specified directory, 
on the server, in the format explained above. CiientID is the value returned by the Login function. 



Function Word 



SendMsg 



>ID 

Message Number 
Explanation 



imGetBinarylnfo 

$00000120 

This message is used to retrieve query results Ifte SELECT in binary format. It is 
useful to get Blobs and image fields. 



Required Payioad SQL query statement 

Payioad Return Pointer to a buffer containing the query result in binary format and the size of the returned buffer 

mbytes. 



Code Example 
(PASCAL) 



BufferStr := 'Select BMP From Animals Where Name = "Boa" 5 ; 

StrPCopy( Buffer , BufferStr ); 

BufferSize:=strLen(Buffer); 

MsglD:=irnGetBinarylnfo; 

SendMsgB( MsgID , CiientID , Buffer .BufferSize); 



Result 



The above example will get a blob field from the table "Animals". The size of the blob is returned 
in 'BufferSize'. 



Function Word 



SendMsgB 



Code Sample 



The example included here shows how to use iocoMRemote . dii for executing your remote COM objects and for querying the 
DLO object at the server. The sample also shows how to connect to a host and invoke the DLO methods using a host message. 

Note: 

You need to import all of your COM objects using the IMetiLinx interface. If you wish to obtain a list of data servers for a given 
host import the DLO object into iManager. 

Dim Obj As Object 
Private Sub Command1_Click() 
Caption = "Connecting.." 

Set Obj = CreateC^ect("k)ComRemote.MetilinxClienr) 

Call Obj.Connect("HOSTr, "192.168.2.84", 1024, "usemamel", "password", "metilinx", status) 
Caption = "Connected to 192.168.Z84" 
End Sub 

Private Sub Command2_Click() 
Dimmsgid As Variant 
Dim res As Variant 
Dim res1 As Variant 
Dim command As Variant 
Dim status As Variant 

'executing a COM object that resides in the server side 

msgid = 2147483650^ the first message after the last iManager reserved message 

'corresponding to hex number 80000002 
command = "select * from authors" 
Call obj.Execute(msgid, command, res, status) 
UbeH .Caption = "value »» " + res 

msgid = 2147483651# the second message after the last iManager reserved message 

'corresponding to hex number 80000003 
command = "HOST1;" + "2400380870" 

Call obj.Executefmsgid, command, res, status) to obtain the data servers 
Labell Caption = "DataServer 1»» " + res(0, 0) + " STATISTICS + res{0, 1) 
Call obj.Execute(msgid + 1 , command, res1 , status) to obtain the connection strings 
LabeGCaption = "ConnStr 1»» ID=" + res1(0, 0) + " CONNSTR-" + res1(0, 1) 
Set res = Nothing 
Set res1 = Nothing 
End Sub 

Private Sub Oxnrnand3_Click() 

Set obj = Nothing 

Unload Me 
End Sub 



Private Sub Form_Load() 
Caption - "Client using ioCOMRanote.DLL" 
End Sub 

Additional Topics: 

Data Load Object 
ioCOMRemote 



Load Data Link File 



If you are specifying a Microsoft Data Link connection, you must load an existing data link (.udl) fife 



Drive Select drive on which the .UDL file resides. 

Folder Select folder on which the .UDL file resides. 

Selected File Path of the .UDL file. 

Selected File Select Data Link Files. 



Load Data Link File 




Load Data Link dialog box 



Source Name 
User ID 
Password 



The Source ID located in the Host detail panel. 
User login ID. 
Password of User ID 




Logon dialog box 



Member Descriptor 



A member descriptor is a five-element array of variant that describes a member (function or property) of an object, including 
parameters and result, if needed. Use it to specify member cadis and marshal results when remotely invoking. 



Mem berDescriptor: Variant containing a one dimensional array of Variant with 5 elements where: 



MemberDescriptor [0] : Nameof the interface the member belongs to. If the member name is a nested 

reference using dot notation, this dement refers to the interface containing the first 
property from the left. 

MemberDescriptor [1] : Name of the member to invoke. Nested references to members (using dot notation) 
allowed. 

MemberDescriptor [2] : Flags describing the invocation context, as follows: 



FLAG NAME 

INVOKE_FUNC 
lNVOKE_PROPERTYGET 
INVOKE^PROPERTYPUT 
INVOKE PROPERTYPUTREF 



FLAG 
VALUE 

1 

2 
4 
8 



DESCRIPTION 

The member is invoked as a 
method. 

The member is retrieved as 
a property or data member 

The member is set as a 
property or data member 

The member is set by a 
reference assignment, 
rather than a value 
assignment. This flag is 
valid only when the property 
accepts a reference to an 
object. 



MemberDescriptor [3] : ParamLst, one dimensional array of Variant with 4 elements describing the parameter 

list. 

ParamLstfO] : Number of parameters the member takes. 
ParamLst[1]: Numer of named parameters 

ParamLst[2]: VarArray with as many elements as parameters the member takes. 
Parameter matching is made from left to right. Values for input 
parameters must be set prior invocation. Type matching between array 
elements and parameters is responsibility of the caller. 

ParamLst[3]: Array of named pararrieters. See examples of how to define the 
Parameter List. 



MemberDescriptor [4] : Variant where the result is marshaled back to the caller, or NULL if the caller expects 
no result This argument is ignored if lNVOKE_PROPERTYPUT or 
INVOKE_PROPERTYPUTREF is specified. 



MetiLinx iManager Messages 



According to their functionality and from the client application's viewpoint, message identifiers can be separated into three different 
categories: Request Messages, Answer Messages and Internal Messages. Whenever the requested action is performed, the Host 
sends an answer message ID (acknowledge message). If errors arise, the corresponding message IDs are sent back. 



Request Messages 

Request Messages are sent from the client to the Host They represent actions the Host system can perform and send results 
or answers back to the client application. There are two kinds of request messages: Stateless Messages and Transaction 
(State-based) Messages. 



Stateless Messages 

After executing a Stateless Message, the Host sends the corresponding reply message back without keeping any reference 
to it. Stateless Messages include update messages and single-shot information requests, as described below. 



Transaction Messages (State-based) 

A Transaction Message is conprised by messages associated to "states" of the Host For example, requests to open a 
table and retrieve its content page by page belong to mis class. Depending on its current state, requests to the Host will be 
accepted or declined. For example, starting a transaction on the database server requires the client close it (by axnmitment 
or rollback). In a different situation, after opening a dataset the client can browse through it, but it must be closed before 
opening a new one. This is the meaning of 'states of the Host". 



Answer Messages 

Answer messages are the replies to the client's requests from the Host. Usually, the Host combines more than one message 
identifier to give additional information about its state and/or to report errors detected while performing the requested action. For 
example, when replying to a single-shot message, the Host might return imDorte, meaning the request was carried out 
successfully and no other information is available. Alternately, it can combine an enor message ki^^ 
identifier to indicate that although information was sent to the client, not all information could be accommodated into the buffer, 
producing an overflow situation. The combination of message identifiers is done using a logical OR operation, so that the AND 
operation has to be used in order to detect the presence of a message identifier in a reply message. 

In case of multiple-shot messages, the Answer message identifiers can inform the client about the cursor position inside the 
dataset, data errors, etc. This facilitates the process of browsing through the dataset and detecting when an endpoint is 
reached. 

Whenever imDone is returned (alone or combined with some other message identifiers), it means the Host was able to obtain 
data and send ft to the client Otherwise, only the corresponding error message identifiers will be sent back to the client, 
indicating that an error was raised during the request execution and the Host could not complete the task. If more information is 
available, it will be sent back as a paytoad. 



Report Answer Messages 

There are other Answer messages the client application might encounter mat originate either at the Host or in the ioRemote 
Object. These are helpful in the debugging of applications during development 



Internal Messages 

Internal Messages are used in the ccrnmunication between the ioRemote Object and the Host to perform operations related to 
client's requests. These messages are not sent to or received by the client therefore, they will not be listed in this document. 



Setup Files 

To download MetiUnx {Manager Developer 2.2 from the MetLinx Web site, you must register and agree to the License T^<*the 
Software License Agreement MetiUnx, Inc. grants. Download the file, HetxiaiucEnterprisea . 2 . exe, to the Download directory. 

Tip: 

Be sure to carefully read the License Terms of the Software License Agreement. MetiUnx, Inc. grants the following licenses for 
the use of MetiUnx iManager Developer 2.2: 

• 30-Day Evaluation 

• Development 

• Enterprise 

Evaluation use of the software begins upon downloading the software and precisely ends 30 days, thereafter. 



To Uninstall MetiLinx iManager Developer 2.2 



1 . On the Start menu, point to Settings, and then select Control Panel. 

2. Double-click on the Add/Remove Programs icon. 

3. Click the InstallAJninstall tab. 

4. From Hie list of programs that Windows can remove, select iManager 2.2. 

5. Click Add/Remove. 

6. At the prompt, dick Yes to confirm that you want to remove the MetiLinx Enterprise 2.2 program. 
Note: 

You may safely respond Yes to All when the uninstall program prompts you to confirm the removal of the following files located in 
C:\ProgramFiiesVCommon MetiUnxVMetiLinx Enterprise 2.2: 

Procdatadll 

Sysdatadli 

MetifinxObjectdll 

Msscriptocx 

QiteryObjectexe 



Microsoft OLE DB provider table 



Provider Name 
SQLOLEDB 

MSDAORA 



Data Source 
SQLServer 

Oracle 



MicrosoftJetOLEDB.4.0 Access/Jet 



|:«is 
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MSDASQL 



MSIDXS 



ODBC 
data source 



File system 



MicrosoftJetOLEDB.4.0 Microsoft 
Excel 

Spreadsheet 



Provider 

Microsoft OLE 
DB Provider 
for SQL Server 

Microsoft OLE 
DB 

Provider for 
Oracle 

Microsoft OLE 
D8 

Provider for Jet 

Microsoft OLE 
DB 

Provider for 
ODBC 

Microsoft OLE 
DB 

Provider for 

Indexing 

Service 

Microsoft OLE 
DB 

Provider for Jet 



Product 

SQLServer 

Any (2) 

Any 
Any 



Any 



Any 



ru 
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Microsoft OLE DB provider table 
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Provider Name 
SQLOLEDB 

MSDAORA 



Data Source 

SQLServer 

Oracle 



MtcrosofUetOLEDB.4.0 Access/Jet 



MSDASQL 



MSiDXS 



ODBC 
data source 



File system 



Microsoft Jet OLEDB.4.0 Microsoft 
Excel 

Spreadsheet 



Provider 

Microsoft OLE 
DB Provider 
fa SQL Server 

Microsoft OLE 
DB 

Provider for 
Oracle 

Microsoft OLE 
DB 

Provider for Jet 

Microsoft OLE 
OB 

Provider fa 
ODBC 

Microsoft OLE 
DB 

Provider fa 

Indexing 

Service 

MiaosoftOLE 
DB 

Provider fa Jet 



Product 
SQLServer 



Any (2) 



Any 



Any 



Any 



Any 
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Welcome 



Welcome to MetiLinx iManager Developer 2.2 and MetiLinx™ technology— Making the Internet Powerful! ™ 

MetiLinx digital technology tools make the Internet a more powerful place to do business, by delivering speed, flexibility, stability, 
dependability, and optimization to commercial, web-based systems. 

Look for new things to come from MetiLinx as we continue to expand our line of optimization and development enhancement 
products. Please visit our Web site at www.mettlinx.com . 



Firewall Settings 



Client application processes may cross a firewall to access an iManager host When you create an Manager host you must assign 
it a port number to enable access to the host through a firewalL 

By default, the iManager host configuration process initially uses connection port 1024 for the first established iManager host Once 
connectivity is established and security access authorized, me host hands off the session to an available socket, then continues to 
listen for port 1024 session requests. 

For each additional host you create with iManager, you must assign a different port number. These port assignments enable 
subsequent hosts to receive session requests. 

Note: 



Set up port 1024 and subsequent ports to use the same rules applied to the HTTP connection port 80 on your firewall. Use ports 
1025 through 5000 with the exceptions of ports 3012 and 4012. iManager reserves these ports for the TLO and SLO components. 



Accessing Database Servers through Business Rule Objects 



iManager provides the COM object, QueryHost (defined in QueryObjectDLL), to giant Business Rule Objects (BRO) access to the 
database servers using the same connection assigned to the client making the request The BRO must create an instance of 
QueryHost and then pass the SQL statement to the created instance, in order to retrieve the data 

For this purpose, the QueryHost interface (IQuery Host) exports a method named RequestQuery. The prototype for this method is: 

procedure RequestQuery(const CmdStn WideString; Cmdlnfo: OleVariant; 

var CmdResult: OleVariant); safecall; 

where 

CmdStr contains the SQL-statement to be executed. 

Cmdlnfo is a parameter passed to the BRO by the host It is a Variant array with six elements , namely: 

Cmd(nfo[0] = Name of the Server for QueryHost (as a wide string). 

Cmdlnfo[1] = used by iManager. 

CmdlnfoP] = reserved for future use. 

Cmdlnfo[3] = reserved for future use. 

Cmdlnfo[4] = reserved for future use. 

CmdlnfofS] = reserved for future use. 
CmdResult returns the resulting data 



Accessing Database Servers through Business Rule Objects 



iManager provides the COM object, QueryHost (defined in QueryObjectDLL), to grant Business Rule Objects (BRO) access to the 
database servers using the same connection assigned to the client making the req uest The BRO must create an instance of 
QueryHost and then pass the SQL statement to the created instance, in order to retrieve the data 

For this purpose, the QueryHost interface (IQuery Host) exports a method named RequestQuery. The prototype for this method is: 

procedure RequestQuery(const CrndStr WideString; Cmdlnfo: OteVariant; 

var CmdResuft OleVaiiant); safecall; 

where 

CmdStr contains the SQL-statement to be executed. 

Cmdlnfo is a parameter passed to the BRO by the host it is a Variant array with six etements, namely: 

CmdlnfofO] = Name of the Server for QueryHost (as a wide string). 

Cmdlnfcff] = used by iManager. 

Cmdf nfof2] = reserved for future use. 

Cmdlnfof3] = reserved for future use. 

Cmdfnfo[4] = reserved for future use. 

Cmdlnfo(5] = reserved for future use. 
CmdResuit returns the resulting data 



Add Users/Groups from External Source 



Administrators can import user IDs and users groups from several types of external sources. The success of the import procedure, 
however, depends on including the exact Information required, as indicated below. 



Source 



Source Kind 



j:: 

s m 



The location from which the collection of user and 
user group information is taken. Enter the 
following source information based on the Source 
Kind: 

SQLServer server name 

WinNT NT domain name 

Oracle service name 

LDAP server IP address 

A code representation of the source program. 
Valid source kinds include: 

WinNT (Windows NT Domain) 

SQL Server and Oracle (Database Server) 

LDAP (Server). 

When the source kind is selected, the iManager 
automatically generates a new source name 
identifier. This identifier is modifiable. 



Source Name 



Administrator ID 
Password 

Database/Directory Name 



Provider 



A unique identifier for a source. The same as the 
Source ID that is part of a user's authentication 
credentials. 

Select New to create a new source name. 
iManager verifies that the name is unique. Do not 
check New if you want to use an existing source 
name. 

The user ID that has administrative authority to 
access the source. 

The password for the administrator ID.. 

If necessary, depending on the kind of external 
source, specify a database name (for database 
servers) or a directory to from which to retrieve 
users and user groups information. 

Select the corresponding database access 
provider or type a connection string. 



Tip: 

Specify only the corresponding source information indicated below: 

Windows NT Source: Domain name or IP address 

Source Kind: WinNT 
Source Name: A unique identifier 

LDAP Source: IP address of the LDAP server 

Source Kind: LDAP 
Source Name: A unique identifier 

SQLServer Source: IP address of the SQL server 

Source Kind: SQLServer 

Source Name: A unique identifier 

Administrator ID: Sysadmin (sa) or an equivalent 
administrator login. Verify type 



of SQL server security. 

Database: Name of the database from which the 
users and user groups are 
being taken. 

Provider SQLOLEDB. 1 a the current Microsoft 
OLE DB provider for SQL 
Server. Otherwise, use 
MSDASQL1, me Microsoft 
OLE DB provider for ODBC 



Oracle Source: The Orade service name (Servername) 

Source Kind: Oracle 

Source Name: A unique identifier 

Administrator ID: Use Internal or an equivalent 
administrator login. 

Provider. MSDAORA,1 for the Microsoft OLE 
DB provider for Oracle 




Additional Topics: 

Microsoft OLE DB providers 



Add/Modify Message 



Message ID Number (DWORD) associated to an alert 

definition. 

Command ID Unique identifier (DWORD) of a command. 



Add/Modify Message 



Modify Connection Object 



Change the status or connection string of a connection object in the Object Repository. 



Connection Object Status Select Active to activate the connection object. 

Select Inactive to pause the connection. If 
i Manager detects a connection failure with a 
connection object, the status of the connection 
object automatically changes to Inactive. Every 15 
minutes, iManager attempts to reconnect the 
connection, if the connection object reconnects, 
iManager changes the status to Active 

Select Out of Service to permanently place an 
object connection offline. If a connection fails to 
reconnect, consider placing it out of service. 



Connection String 



Select to modify the connection string parameters 
of the connection obgect 



Modify Settings Parameters 



Agent Refresh Time Use this parameter to adjust, in seconds, how 

often iAgent checks the Host status and 
activates its data publishing mechanism. 

Minimum Value: 5 

Maximum Value: 3600 

Recommended Value: 10 



Log Refresh Time Use this parameter to adjust, in seconds, how 

often iManager retrieves messages from the 
administration database when logging is 
enabled. 

Minimum Value: 1 
Maximum Value: 100 
Recornrnended Value: 5 



Log View Entries Use this parameter to adjust the number of 

message displayed in the Log window. 

Minimum Value: 100 

Maximum Value: 5000 

Recomrnended Value: 500 



Screen Refresh Time Use this parameter to adjust, in seconds, how 

often the Host Status information in the Hosts 
window updates. 

Minimum Value: 3 

Maximum Value: 100 

Recxxnmended Value: 10 
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Settings Parameters 



Note: 

Decreasing the parameters to the lowest settings is not recommended, as doing so will slow down the Host performance. 



Modifying a Connection Object 



1. At the MetiLinx tree, dick Object Repository; then click Connection Objects. 

2. In the right pane, fight-click the Connection Object you wish to modify; then dick Modify Connection Object. 



iManager opens the Modify Connection Object window. 




3. If you want to, modify the Connection Object Status , 

4. Click Connection String. 

5. Click OK to implement the changes. 



Modifying a Script 



1 . Select the script you want to modify located in Object Repository > Business Rules Objects > Scripts. 

Z Click Action f Modify Script 

3. Make the changes and click OK to implement them. 



o 
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Modifying an Object 



1 . Click the COM Object you want to modify found in Object Repository >Business Rules Objects >COM Objects. 

2. Click Action | Modify Object 



iManager opens the Modify COM-Object dialog box. 




There are two available tools on the "Modify COM-Objecf screen: 

Verify COM Object This feature will test your object properties for accuracy. 

Register COM Object This feature will register your object with the local System. 

3. Modify the object and click OK to save your changes. 

Additional Topics: 

Verifying COM objects 



To Uninstall MetiLinx iManager Developer 2.2 



1 . On the Start menu, point to Settings, and then select Control Panel. 

2. Double-dick on the Add/Remove Programs icon. 

3. Click the Install/Uninstall tab. 

4. From the list of programs that Windows can remove, select IManager 2.2. 

5. Click Add/Remove. 

6. At the prompt, dick Yes to confirm that you want to remove the MetiLinx Enterprise 2.2 program. 
Note: 

You may safely respond Yes to AH when the uninstall program prompts you to confirm the removal of the following files located 
C:\ProgramFiles\Common \MetiLinx\MetiUnx Enterprise 2.2: 

Procdatadll 

Sysdatadil 

MetHin*Objectdil 

Msscriptocx 

QueryObjectexe 



Navigating in iManager 



MetiLinx iManager follows standard Windows navigation features, which allow you to carry out the same command in more than one 
way. 

Double-click feature 

Use the double-click feature to expand the MetiLinx root and view the MetiLinx tree. Double-click the last subcomponent of a 
component to carry out the Modify command. 

Right-click feature 

Use the right-click feature to view a component menu. Right-clicking a component within the MetiLinx tree (control pane) provides a 
menu with limited list of enabled commands for mat component Right-clicking a component within the details pane (right pane) 
provides a menu with a complete Fist of enabled commands for mat axnponent For example, if you right-click Hosts in the control 
pane, the enable commands that appear are Med to Add New Host and Help. When you right-click on a host system displayed on 
the right pane, Modify Host, Delete Host, Run Host and Help are enabled. 





Hosts right-click menu from left panel 



Host system right-click menu from right panel 



Drag and drop feature 

Use the iManager drag-and-drop feature to complete host maintenance tasks. 

• Add users to a Host System by dragging and dropping User IDs from PP Users into W Host Users. 



♦ Add Connection Objects to a Host System by dragging and dropping connection objects from the HP Object Repository 
to Connections. 



Additional Toots 

(Agent is a utility application that starts the iManager components. The iManager installation places a shortcut to the Agent in the 
Startup group for Ail Users, so that the agent runs at logon time. By default, the agent starts each host the Transaction Load Object 
(TLO)and the optimization COM-objects. 

(Agent checks the iManager administrative database for hosts mat have the automatic startup property enabled and starts them. As 
each host publishes its information to the database upon starting up, iAgent detects the host presence and activates the host's 
publishing mechanism. iAgent also creates and manages instances of SysCounters to retrieve information about every server on 
which a host resides. There will be one object per server. Simultaneously, iAgent creates a single instance of MetiProc, in order to 
calculate the statistics for each host 



iAgent can also be used to start other applications. Simply edit the text file 3rdPartyApp . ini, located in the iManager installation 
folder. Use the following format for your entries: 

[<Appiicatton Name>l 

Active=<YES/NO> 



Patfi=<Full App Path Including executable name> 
F^rametefs=<Command-line parameters, if needed> 

Mode=<NORMAL/HH»MINlMIZE^IAXIMIZE> 



Application name 



Identifies the application section in 
the INI file 



Active 



I ndicate Yes to enable iAgent to 
start the application. Otherwise, 
indicate No. 



Path 



The full path of the application 
location 



Parameters Contains space separated, 

axnmand-iine parameters required 
for running the application 



Mode Indicates the application's default 

window properties. This mode 
parameter is passed to the 
application executing the function. 

By default, a single entry for TLO is written in this file. 



■Manager Toolbar Buttons 



Button 


Command 


m 


Add 


S 


Add New User/External Source 


K 


Delete/ Remove 


SH 


Exit /Close 


M 


Rter 


e§ 


Modify 




Run Host 


B 


Stop Host 


m 


Verify 


m 


View All 




Object/Script Messages 


m 


Script Objects 



Network Connectivity Requirements 



♦ Static IP address on iManager client server 

• ODBC/OLE DB connection to each database 



Network Connectivity Requirements 



• Static IP address on iManager client server 

• ODBC/OLE DB connection to each database 



COM Object Messages 



Actions performed by COM objects are identified by Command ID numbers. Duplication of these ID numbers can occur within other 
scripts and objects, and are often associated to different actions. To manage such duplication among objects, iManager provides an 
system of identification that allows developers to assign unique message IDs to object actions, while maintaining the development 
team's proprietary numbering system. 



How the message mapping works 

Given: 

Message ID =3 
CornmaxilD =6 

Result 

ImUserMsgID (0x80000001) + Message ID (3) = (0x80000004) and maps to Command ID 6 for the object. 
To map command IDs 

1 In the Com Objects dialog box, located under Business Rules Objects, click the object you want to add a message to. 
2. Click on Action j Object Messages. 

iManager opens the Messages window. 



Command ID 
ImUserMsgID 



Message ID 



Number (DWORD) associated to an alert 
definition. 

Unique identifier (DWORD) of a command. 

A hexidecimal constant (0x80000001 ) added to 
the Message ID to create a unique hexkteciaml 
number that maps to the Command ID. 




3. Click Add. 



iManager opens the Add/Modify Message dialog box 



4. Type a number in the Message ID box to create your unique ID. 



An error message appear, if the number selected is already in use. 

5. Type the Command ID number used in your object. 

6. Click the OK to return to the Messages dialog box. 

Repeat the above steps to add additional messages to the object. You can also Modify or Delete the Message IDs 



What's New with MetiLinx iManager Developer 2.2 



MetiLinx Enterprise 2.1 has branched out to MetiLinx iManager Developer 2.2 (iManager) and MetiLinx iSystem Enterprise 2.2 
(iSystem). iManager is a development tool that aids developers in building e-business systems. These systems subsequently inherit 
the MetiLinx optimization technology. This release of iManager delivers a broad range of object support and rnanagernent in an open 
environment 

S Dual interface support for scripting languages 

MetiLinx iManager Developer 2.2 supports the IDispatch interface to enable developers working in 
scripting languages, such as VBScript and JScript, to access the iManager Repository components. 

S New! Script Editor 

The new Script Editor offers basic editing support, enabling developers to edit code from generic and 
marshalling scripts. 

V Enhanced remote COM management 

With MetiLinx iManager Developer 2.2, MetiLinx continues to build and expand upon the remote COM 
management functionality and open environment of MetiLinx Enterprise 2. 1 . Enhanced features include: 

• Improved object streaming 

o Enables remote object handling without the need to register the client 

o Promotes code efficiency 

o Supports local and remote calling on client 

• Object repository management 

• Access to host-level information, such as, connection objects, repository objects, and user 
connections. 



Object Repository Components 



Business Rules Objects: COM objects supplied by the developer to be accessed by the Host using extended message IDs. 



Intelligence Objects: 



Objects implementing the published IMetiLinx COM-interface. Communication between Host and 
objects occurs through the ProcessCommand function. iManager creates and destroys instances. 



Generic Objects: 



iManager interface is not implemented. Managed through Marshalling Scripts and metanames. 
iManager is responsible for creating and destroying object instances. 



Marshalling Scripts: Source code and properties stored in the Object Repository. Several generic objects can be 

associated with a script iManager c^es object instances and passes ft 
predefined metanames. The correct use of objects is the responsibility of the script imptementer. 
Function ProcessCommand has to be implemented. Host-Script communication occurs through this 
function (similar to the first case, but fenptemented in a script). 



Generic Scripts: Source code and properties are stored in the Object Repository. No objects are explicitly associated 

with them. iManager is responsible for executing source code. The Script is in charge of creating the 
objects it might need. Function ProcessCommand has to be implemented. Host-Script communicatjon 
occurs through this function (similar to the first case, but implemented in a script). 



Connection Objects 



ADO (database connection objects) created through iManager interface to be accessed by the Hosts 
using standard message ids. 



What's New with MetiLinx iManager Developer 2.2 



MetiLinx Enterprise 2.1 has branched out to MetiLinx iManager Developer 2.2 (iManager) and MetiLinx iSystem Enterprise 2.2 
{iSystem). iManager is a development tool that aids developers in building e-business systems. These systems subsequently inherit 
the MetHJnx optimization technology. This release of iManager delivers a broad range of object support and management in an open 
environment. 



S Dual interface support for scripting languages 

MetiLinx iManager Developer 2.2 supports the IDispatch interface to enable developers working in 
scripting languages, such as VBScript and JScript, to access the iManager Repository components. 

S New! Script Editor 

The new Script Editor offers basic editing support, enabling developers to edit code from generic and 
marshalling scripts. 

S Enhanced remote COM management 

With MetiLinx iManager Developer 2.2, MetiLinx continues to build and expand upon the remote COM 
management functionality and open environment of MetiLinx Enterprise 2. 1 . Enhanced features include: 

♦ Improved object streaming 

o Enables remote object handling without the need to register the client 

o Promotes code efficiency 

o Supports local and remote calling on client 

♦ Object repository mariagement 

♦ Access to host-level information, such as, connection objects, repository objects, and user 
connections. 



Using SQL Server 7 



If you are using SQL Server 7 as your Database Management System (DBMS), then follow these instructions to create the iManager 
administrative database. 

To create the administrative database 

1 At the iManager Developer 2.2 Configuration window, select Microsoft SQL Server, then click Next. 

2. CDck Edit Connection String to create the ADO connection string. 

3. Click the Provider tab, and select Microsoft OLE DB Provider for SQL Server. 

4. Click Next 

5. Click the Connection tab, and select or enter a name in the Server Name box 

6. Enter a Usemame (typically, S A) and Password. (Verity the type of security SQL Server uses— Windows NT Only 
(Integrated) or SQL Server and NT.) 

7. Click OK then click OK, again, at the Create Connection Object window. 
Note: 

Do not complete Step 3 of the Connection tab. tf you do, you will receive error messages because the administrative database 
does not yet exist. 

8. Click OK to test the connection object. 

9. Enter the Usemame and Password you previously indicated. 

1 0. Select the Create New User check box to create a separate administrative account to administrate the iManager database. 

1 1 . Enter a Username and Password, confirm the password, and then click Next. 

12. Enter a Name, for example, MetiUnx, for the new iManager administrative database. 

13. Click Run AH to create the database. 

Once the installation process builds the administrative database, it is complete. 
Note: 

Do not edit the connection string. The only time the connection string is altered, is when you reinstall the application. When you 
do, a new database overwrites the previous administrative database. 



OLE Messages 



i ID ImGetOLEData 

Message Number $10000001 

Explanation This message is used to retrieve any amount of data (resulting from the execution of a SQL 

Statement) formatted as an OLE object. 



Required Paytoad SQL-Statement as string. 

Payfoad Return OLE object containing data 

Code Example WideStr= "SELECT *from AVTD;" 

(PASCAL) MsglD:= imGetOLEData 

SendMsgOLE (MsglD, CfientlD, WkfeStr, varResult); 



Result 

Function Word 



varResult will contain the retrieved data as a Recordset. 
SendMsgOLE 



Opening Connections to a Host 





procedure Connect (const Host 


WideString; 


// 




IPAddress : 


WideString; 


//IP address of the application server 
where the host is running. 




Port 


SYSINT; 


// The IP Port being utilized to make 
thecal! 




const Usemame 


WideString; 


//User name security credential 






vvioeoinng, 


//r'assworo security credential 




SourcelD 


WideString; 


// 




var Status : 


OteVariant ); safecall 


//Status = 0, if Connect successful. 
Status o 0 otherwise. 




Description: Opens a connection to a Host. 






ill . 


procedure Reconnect ( const Host 


: WideString; 


// 


Lit 


IHACKJPeSS 


. WKieotnng, 


//IP address of the application server 
where the host is running. 


lis! 


Port 


: SYSINT; 


// The IP Port being utilized to make 
tne can 




const Usemame 


: WideString; 


. //User name security credential 




Password 


: WideString; 


//Password security credential 




SourcelD 
OpenDataset 


: WideString; 
: WordBod; 


// 

//Returns TRUE, if user had an 
open dataset before connection 
breakdown. FALSE, otherwise. 


PI 


OpenTransaction 


:WordBool; 


//Returns TRUE, if user was inside 
a transaction before connection 
breakdown. FALSE, otherwise. 




var Status 


: OfeVariant ); safecal!; 


//Status = 0, if Reconnect 
successful. Status o 0 otherwise. 



Description: Attempts to reconnect to a host, if connection was abruptly interrupted. 



Opening Connections to Host 



( HostName 


: PChar; 


//Host the connection targes 


ServerAddr 


: PChar; 


//IP address of the application 
server where the host is running 


UserName 


: PChar; 


//User name security credential 


Password 


: PChar; 


//Password security credential 


Port 


:WORD; 


//The IP Port being utilized to 
make the call 


SourcelO 


: PChar = NIL ):LongWord; stdcall 


//Client's SourcelD. Comprised of 
the user credentials. 



Description: This function is used to establish a connection with the Host Connection may fail if the Host Name provided is wrong 
a the port settings ck>rK*matc^ Connection may also be denied if the User Name, 

Password and SourcelD are not valid. 

Returns: If connection is established, Host is found and the User Name, Password, SourcelD of the client is verified then ft 
returns a ClientID that is a unique identifier for the UserName, otherwise it returns 0. 

Example in PASCAL: 

StrCopy(Hosmarne,'TEST'); 

StrCopy(HostAddr/1 1 1 .1 1 11 1 1.1 1 V); 

StrCopyCUsername/Bob*); 

StrCopy(Passw<xd,'1234'); 

SfrCopy(SourcelD t 'Metilin)C); 

Pport:=1024; 

ClieritiD:=togin(Hostna^ 

Pport, SourcelD); 



The above example connects the user "Bob" to the Host "TEST" running at IP address 
"111.111.111111". 



//Host the connection targets 

//IP address of the application 
server where the host is running 

//User name security credential 

//Password security credential 

//Contains an error message if 
there is one 

// The IP Port being utilized to 
make the call 

//Client's SourcelD. Comprised of 
the user credentials. 

Description: This function is used to establish a connection with the Host the same way as 'function Login 7 except that this function 
also returns the error message if any resulting from the connection attempt The connection may fail if the HostName 
provided is wrong or the port settings do not match between the client and the Host Connection may also be denied if 
the UserName, Password and SourcelD are not valid- 
Returns: If connection is established, Host is found and the User Name, Password of the client is verified. Then it returns a 
ClientID that is a unique identifier for the UserName, otherwise it returns 0. 



(HostName 


: PChar; 


ServerAddr 


: PChar; 


UserName 


: PChar; 


Password 


: PChar; 


LoginEnor 


: PChar, 


Port 


:WORD; 


SourcelD 


: PChar = 



Example in PASCAL: 

StrCopy(Hostname t 'TEST'); 

StrCopy(HostAddr/1 1 1 .1 1 11 1 1 1 1 1 '); 

StrCopy^Usemame/Bob 1 ); 

StrO3py(Password,'12340; 

GetMem(L£rror,1024); 

StrCopy{SourceiD,'Metiiinx'); 



Pport:=1024; 

ClientlD:=Login(Hostnane l HostAddress,Usemame,Passv^ LError 
PportSourcelD); 



The above example connects the user "Bob" to the Host "TEST" running at IP address 
"111.111.111.111". If login is unsuccessful, a null terminated string coritaining an error message is 
returned in LError, 



function LoginTLO ( var HostName : PChar; 



ServerAddr 



out Port 



UserName 



Password 



SourceJD 



: PChar; 



:WORD; 



PChar; 



PChar; 



//Name of the Host the 
connection targets 

//IP address of the 
application server where 
the host is running 

//The IP Port being 
utilized to make the 
function call 

//User name security 
credential 

//Password security 
credential 



: PChar = NIL ):LongWord;stdcall //Client's SourcelD. 

Comprised of the user 
credentials. 

Description: This function is used to request a TLO to open a connection to a host Depending on the current TLO information, an 
equivalent host will be selected and a connection will be opened. 

Returns: If connection is established, Host is found and the User Name, Password of the client is verified. After this it returns a 
ClientID that is a unique identifier for the UserName, otherwise it returns 0. 



Example in PASCAL: 



StrCopy(Hostname,TESP); 
StiCopy(HostAddr/ 1 1 1 . 1 1 1 . 1 1 1 1 1 1 • ) ; 
StrCcpytUsername.'Bob'); 
StrCoprtPasswcrd,^^'); 

StrCopy(SourcelD,'Meti^inx , ); ^ 
C(ientJD:=lxginTLO(Hcstriarr)e,HostAddfess^ 
PportSourcelD); 

The above example requests a TLO object running at "1 1 1.1 1 1.1 1 1.1 1 1" to open a connection to a 
host equivalent to TEST" using the credential of user "Bob". 



function Reconnect ( HostName ; PChar; 

ServerAddr : PChar, 

UserName : PChar; 

Password : PChar; 

Port : WORD; 

out OpenDataset : WORDBool 



//Host the connection 



//IP address of the 
application server 
where the host is 
running 

//User name security 
credential 

//Password security 
credential 

//The IP Port being 
utilized to make the call 

Returns TRUE, if user 
has an open dataset 
before connection 
breakdown. FALSE, 
otherwise. 



OpenTransaction : WORDBod Returns TRUE, if user 

):LongWord;stdcall was inside a 

transaction before 
connection breakdown. 
FALSE, otherwise 

Description: Attempts to reconnect connection to host, if connection is abruptly interrupted. 



Returns: ClientIO (o 0), if reconnection was successful. 

Example in PASCAL 

StrCopyCHostnarr^TEST'); 
StrCopy(HostAddr,'1 1 1.1 1 1 .1 1 1.1 1 1 >); 
StrCopKUsemarne/Bob'); 
StrCopy(Password/1234'); 
Pport=1024; 

ClientiD:^e<^nect(Hostname 3 HostAddress, Username, Password, 
Pport.OpenDataset, OpenTransaction); 

The above example attempts to reconnect user H Bob H to host TEST 1 . 



Member Descriptor 



A member descriptor is a five-element array of variant that describes a member (function or property) of an object, including 
parameters and result, if needed. Use it to specify member calls and marshal results when remotely invoking. 

Member Descriptor; Variant containing a one dimensional array of Variant with 5 dements where: 

MemberDescriptor [0] : Name of the interface the rnernber belongs to. if the member name is a nested 

reference using dot notation, mis element refers to the interface containing the first 
property from the left 

MemberDescriptor [1] : Name of the member to invoke. Nested references to members (using dot notation) 
allowed. 

MemberDescriptor [2] : Rags describing the invocation context, as follows: 



FLAG NAME 

INVOKE_FUNC 
INVOKE_PROPERTYGET 
INVOKEJ>ROPERTYPUT 
INVOKE PROPERTYPUTREF 



FLAG 
VALUE 

1 
2 
4 
8 



DESCRIPTION 

The member is invoked as a 
method. 

The member is retrieved as 
a property or data member 

The member is set as a 
property or data member 

The member is set by a 



rather than a value 
assignment This flag is 
valid only when the property 

accepts a reference to an 
object. 



MemberDescriptor [3] : ParamLst, one dimensional array of Variant with 4 elements describing the parameter 
list 

ParamLst[0]: Number of parameters the member takes . 
ParamLst[1]: Numer of named parameters 

ParamLstp] : VarArray with as many elements as parameters the member takes. 
Parameter matching is made from left to right. Values for input 
parameters must beset prior invocation. Type matching between array 
elements and parameters is responsibility of the caller. 

ParamLst[3]: Array of named parameters. See examples of how to define the 
Parameter List. 



MemberDescriptor [4] : Variant where the result is marshaled back to the caller, or NULL if the caller expects 
no result This argument is ignored if INVOKE_PROPERTYPUT or 
INVOKEJPROPERTYPUTREF is specified. 



To Uninstall MetiLinx iManager Developer 2.2 



1. On the Start menu, point to Settings, and then select Control Panel 

2. Double-click on the Add/Remove Programs icon. 

3. Click the fnstall/Uninstafl tab. 

4. From the list of programs that Windows can remove, select iManager 2.2. 

5. Click Add/Remove. 

6. At the prompt, click Yes to confirm that you want to remove the MetiLinx Enterprise 2.2 program. 
Note: 

You may safely respond Yes to All when the uninstall program prompts you to confirm the removal of the following files located in 
C:\ProgramFiles\Common \MetiUnx\MetiUnx Enterprise 2.2: 

Procdatadll 

Sysdatadll 

MetilinxObjectdll 

Msscriptocx 

QueryObjectexe 



To Install MetiLinx iManager Developer 2.2 



1 . Close all programs, including virus-checking programs. 

2. On the Start menu, select Run. 

3. Click Browse to locate your Download folder. 

4. Type or select the file name metilinxenterprise2.2.exe t and then click Open to run the file. 

5. Follow the instructions of the InstaHShiekJ Wizard. 

♦ Choose Destination Folder 

By default, iManager 2.2 is installed in C:\Program Hies\MetiUnx\MetiLinx Enterprise 2.2. 

• Select Program Folder 

By default, the program folder is MetiLinx Enterprise 2.2. 

Note: 

You must have full Administrator rights to the local machine. 
You are now ready to create the iManager administrative database. 
Additional Topics: 

To create the iManager administrative database using SQL Server 7 
To create the IManager administrative database using Oracle 8i 



Proprietary User 



( 

Create a unique i Manager user login ID. Select Administrator to enable administrative access to i Manager. Access to the iManager 
program is restricted to administrators. 



User Name 
User ID 

Password 

Password Confirmation 



Actual name of the user. Can be the same as the 
User JO. 

Actual user login ID. User IDs are limited to 20 
alpha-numeric characters, with the first character 
restricted to a letter. 

Password for login ID. Passwords are limited to 
20 alphanumeric characters, with the first 
character restricted toa letter. 

Password confirmation for login ID. 



Prototype of the interface IDataLoadObject 



procedure getDateServers 



{const Host 
ClientID 

out DafcaServerList 



WideString; 
OteVariant; 
OteVariant); safecall; 



procedure getConnStrings ( const Host 
CiientID 
out ConnStrtJst 



WideString; 
OteVariant; 
OteVariant); safecall; 



procedure doseADOconn ( ConnID 



: OteVariant); safecall; 



procedure openADOconn ( ConnID 

outConnADO 
ConnOpenedID 



: OteVariant; 
: OteVariant; 
: OteVariant); safecall; 



ProcessCommand ( CmdID 

const CmdStr 

Cmdlnfo 
varCmdResult 



: LongWord; //= 1 (to pull the data servers fist) 

: WkfeString; // = <Host nane>;<Clten«D> 

Example: CmdStr = 'Host1; 1277608648' 

: OteVariant; 

: OteVariant); safecall //A two dimensional array with the data 
; servers information 

Description: This additional object also implements the interface IMetilinx, which is accessible through the function. 
PrccessCommand 



if = 2 (to pull the connection string list) 
// = <Host name>;<ClientlO> 



( CmdID : LongWord; 

const CmdStr : WideString; 

Cmdlnfo : OteVariant; // 

varCmdResult : OteVariant); safecall //A two dimensional array with the data 
; servers information 

Description: This additional object also implements the interface IMetilinx, which is accessible through the function. 



ProcessCommand ( CmdID : LongWord; 

const CmdStr : WideString; 

Cmdlnfo : OteVariant; 

var CmdResult : OteVariant); 



// = 3 (to open an ADO connection using ; 
connection ID) 

//<Connectk>nlD> 



// A two dimensional array containing the 
ADO connection object and a 
cormedkxvopened-ID. 

Description: This additional object also implements the interface IMetilinx, which is accessible through the function. 



ProcessCommand 



( CmdID 
const CmdStr 
Cmdlnfo 
varCmdResult 



LongWord; 

WideString; 

OteVariant; 

OteVariant); 
safecall; 



// = 4 (close a currently open connection) 

// = <ConnectionOpenedlD> 

// 

//= No values returned 



Description: This additional object also implements the interface IMetilinx, which is accessible through the function. 
Note: 

Please observe the parameter differences when using different CmdID values. 



Prototype of the interface IDataLoadObject 



procedure getDataServers ( const Host 
ClientID 

out DataServerflJst 



WideString; 
OteVariant; 
OleVariant); 



procedure getConnStrings (const Host 
ClientID 
outConnStrtist 



WideString; 
OleVariant; 
OleVariant); 



procedure closeADOconn ( ConnID 



: OleVariant); safecall; 



procedure openADOconn 



(ConnID 

outConnADO 

ConnOpenedlD 



OleVariant; 
OleVariant; 
OleVariant); 



ProcessCommand ( CmdID 

const CmdStr 

Cnxllnfo 

var CmdResult 



: LongWord; 
: WideString; 

OleVariant; 
OleVariant); safecall 



//= 1 (to pull the data servers list) 
// = <Host name>;<ClientlD> 
Example: CmdStr = 'Host! ; 1277608646' 



//A two dimensional array with the data 
servers information 



Description: This additional object also implements the interface IMetilinx, which is accessible through the function. 



ProcessCornmand 



( CmdID 
const CmdStr 
Cmdlrtfo 
var CmdResult 



LongWord; 
WideString; 
OleVariant; 
OteVariant); safecall 



// = 2 (to pull the connection string list) 

// = <Host name>;<ClientlD> 

// 

// A two dimensional array with the data 
servers information 



Description: This additional object also implements me interface IMetilinx, which is accessible through the function. 



PrcxxssCornmand ( CmdID 



const CmdStr 
Cmdlrtfo 
var CmdResult 



: LongWord; 

WideString; 
OleVariant; 
OleVariant); 



//= 3 (to open an ADO connection using a 
connection ID) 

//<ConnectionlD> 



// A two dimensional array containing the 
ADO connection object and a 
connectkxvopened-ID. 

Description: This additional object also irnpternents the interface IMetilinx, which is accessible through the function. 



ProcessCommand 



( CmdID 
const CmdStr 
Cmdlnfo 
var CmdResult 



LongWord; 
WideString; 
OleVariant; 
OleVariant); 



If =4 (close a currently open connection) 
// = <ConnectionOpenedlD> 

// 

// = No values returned 



Description: This additional object also implements the interface IMetiiinx, which is accessible through the function. 
Note: 

Please observe the parameter differences when using different CmdID values. 



Using SQL Server 7 



If you are using SQL Server 7 as your Database Management System (DBMS), then follow these instructions to create the iManager 
administrative database. 

To create the administrative database 

1 At the iManager Developer 2.2 Configuration window, select Microsoft SQL Server, then dick Next. 

2. Click Edit Connection String to create the ADO connection string. 

3. Click the Provider tab, and select Microsoft OLE DB Provider for SQL Server. 

4. Click Next 

5. Click the Connection tab, and select a enter a name in the Server Name box. 

6. Enter a Usemame (typically, SA) and Password. {Verify the type of security SQL Server uses—Windows NT Only 
(Integrated) or SQL Server and NT.) 

7. Click OK then click OK, again, at the Create Connection Object window. 
Note: 

Do not complete Step 3 of the Oxinection tab. If you do, you will receive error messages because the administrative database 
does not yet exist 

8. Click OK to test the connection object. 

9. Enter the Usemame and Password you previously indicated. 

10. Select the Create New User check box to create a separate administrative account to administrate the iManager database. 

1 1 . Enter a Usemame and Password, confirm the password, and then click Next 

12. Enter a Name, for example, MetiUnx, for the new iManager administrative database. 

13. Click Run All to create the database. 

Once the installation process builds the administrative database, ft is complete. 
Note: 

Do not edit the connection string. The only time the connection string is altered, is when you reinstall the application. When you 
do, a new database overwrites the previous administrative database. 



To Uninstall MetiLinx iManager Developer 2.2 



1 . On the Start menu, point to Settings, and then select Control Panel 

2. Double-click on the Add/Remove Programs icon. 

3. Click the Install/Uninstall tab. 

4. From the fist of programs that Windows can remove, select iManager 2.2. 

5. Click Add/Remove. 

6. At the prompt, click Yes to confirm that you want to remove the MetiLinx Enterprise 2.2 program. 
Note: 

You may safely respond Yes to All when the uninstall program prompts you to confirm the removal of the following files located in 
C:\ProgramFHes\Common \MetiLinx\MetiUnx Enterprise 2.2: 

Procdatadll 

Sysdata.dll 

MetilinxObjectdll 

Msscript.ccx 

QueryObject.exe 



Removing Connections from a Host 



iManager allows administrators to remove host connections. Removing a host connection, however, does not delete the connection 
from the Object Repository. 

1 . Expand the Hosts folder, and then expand the fofder of the host to which you wish to modify the security of a connection, 

2. in the right pane, right-click the connection, and then click Remove Connection, 
-or- 

Click the connection, and then click the Remove Connection button on the toolbar. 

3. In the iManager Message dialog box, click OK to confirm the deletion. 



What's New with MetiLinx iManager Developer 2.2 



MetiUnx Enterprise 2. 1 has branched out to MetiLinx iManager Developer 2.2 (iManager) and MetiLinx iSystem Enterprise 2 2 
(iSystem). iManager is a development tool mat aids developers in building e-business systems. These systems subsequently inherit 
the MetiLinx optimization technology. This release of iManager delivers a broad range of object support and management in an open 



* Dual interface support for scripting languages 

MetiUnx iManager Developer 2.2 supports the IDispatch interface to enable developers working in 
scripting languages, such as VBScript and JScript, to access the iManager Repository components. 

S New! Script Editor 

The new Script Editor offers basic editing support, enabling developers to edit code from generic and 
marshalling scripts. 

v Enhanced remote COM management 

With MetiUnx iManager Developer 2.2, MetiUnx continues to build and expand upon the remote COM 
management functionality and open environment of MetiUnx Enterprise 2.1. Enhanced features include: 

♦ Improved object streaming 

o Enables remote object handling without the need to register the client 

o Promotes code efficiency 

o Supports local and remote calling on client 

♦ Object repository rnanagement 

♦ Access to host-level information, such as, connection objects, repository objects and user 
connections. 



The Repository Info Interface 



This object implements an Interface named iRepository Info that contains the following methods: 
HRESULT _stdcall GetComObjectListftout, retvag VARIANT * COMObjList ) 
HRESULT _stdcall GetScriptListtfput, retval] VARIANT * ScriptUst ) 
HRESULT _stdcall GelO«ec«nfo(Pn] BSTR ProglD, [out retval] VARIANT * Objectlnfo ) 

HRESULT _stdcall lslnRepository(pn] BSTR ProglD, {out, retval] VARIANTJJOOL * ResuWs ) 

x 

HRESULT _stdcall lsAssigned{[in] VARIANT Msgld, [out] VARIANT * Owner, [out] VARIANT * Ownerid, [out, retval] 

VARIANT-BOOL * Resuftls ) 

Using these methods, callers can obtain information about the contents and settings of the Repository. 



M GetComObjectList([out, retval] VARIANT * COMObjList ) 



GetComObjectList returns a list of all COM-objects contained in the Repository. The resulting data has the following structure: 

• COMObjList is a one-dimensional zero-based varArray containing as many positions as objects are in the repository. 

• Each position in the array (Objlnfo) is again a one^imensional zero-based varArray with 5 positions, defined as follows: 

ObjlnfofO]: Contains the ObjlD assigned to this object 

Objlnfo [1]: Contains the Programmatic ID of the object as WideString. 

Objlnfo [2]: Contains the Description associated to the object as WideString. 

Objlnfo [3]: Contains the Category the object belongs to as WideString. There are currently two possible 

categories: "COM Object" and "Intelligence Object". 

Objlnfo [4]: When the Category is "Intelligence Object", it contains a one-dimensional zero-based 

varArray with a list of Message IDs associated to this object Unassigned, if the Category is 
"COMObjecT. 

• If there are no objects in the Repository, COMObjList will return NULL 

• If errors occur white accessing the Repository, the return value will be -20010 (error accessing admin database). 
GetScriptListgout, retval] VARIANT * ScriptList ) 

GetScriptlist returns a list of all scripts contained in the Repository. The resulting data has the following structure: 

• ScriptList is a orie-drnensional zero-based varArray containing as many positions as scripts are in the repository. 

• Each position in the array (ScriptDesc) is again a one^irnenskrai zero-based varArray with 5 positions, defined as follows: 

ObjDescfO]: Contains the ScriptID assigned to this script. 

ObjDesc{1]: Contains the Description associated to the script as WideString. 

ObjDesc[2]: Contains the Category the script belongs to as WideString, There are currently two possible 

categories: "Generic Script" and "Marshalling Script". 

ObjDesc[3]: When the Category is "Marshalling Script", ft contains a one-dimensional zero-based 

varArray with a list of Obj IDs associated to this script Unassigned, if the Category is 
"Generic Script". 

ObjDescKJ: When the Category is "Marshalling Scripf, ft contains a one<limensional zero-based 

varArray with a list of Message IDs associated to this script Unassigned, if the Category is 
"Generic Scripf. 

• If there are no objects in the Repository, ScriptUst will return NULL. 



• If errors occur white accessing the Repository, the return value will be -20010 (error accessing admin database). 
OetObjecttnfoflm] BSTR ProglD, [out, retvafj VARIANT * Objectlnfo ) 

GetObjectlnfo returns a list of all COM-objects contained in the Repository with Programmatic ID ProglD. The resulting data has 
the following structure: 

• Objectlnfo is a one-dimensional zero-based varArray containing as many positions as objects are in the repository with the 
corresponding Programmatic ID. 

• Each position in the array (Objlnfo) is again a one-dimensional zero-based varArray with 5 positions, defined as follows: 

ObjlnfcfO]: Contains the ObjiD assigned to this object 

Objlnfo [1]: Contains the Programmatic ID of the object as WideString. 

Objlnfo [2f Contains the Description associated to the object as WkteString. 

O&jlnfo PI: Contains the Category the object belongs to as WideString. There are currently two possible 

categories: "COM Object" and "intelligence Object". 

Objlnfo [4]: When the Category is "Intelligence Object", it contains a ate^mensionai zero-based 

varArray with a list of Message IDs associated to this object Unassigned, if the Categor/ is 
COM Object". 

• If there are no objects in the Repository with the corresponding Programmatic Id, Objectlnfo will return NULL. 

• If errors occur while accessing the Repository, the return value will be -2001 0 (error accessing admin database). 



lslnReposStory(Pnj BSTR ProgfP, [out, retvaQ VARIANT_BOOL * Resuftte > 



islnReposltory returns TRUE, if there is at least one COM-object in the Repository, whose Programmatic 5 Id is ProglD. FALSE is 
returned otherwise. 



tsAssjgned( P"I VARIANT Msgfd, [out] VARIANT * Owner, [out] VARIANT * Ownerid, [out, retvaQ VARIANT_BOOL - 
Resultls > * ^ 



^Assigned returns TRUE, Msgld is assigned to some COMobject or Script from the Repository. In this case, the identity of the 
owner is described through Owner ("Object" or "Script") andtheOwneriD (Objld or Scriptld). FALSE is returned otherwise. 

The IMetiUnx interface implementation for this object is as follows: 

Cradld {Method Invoked (using CmdStr and CmdResult) 

1 ICmdResalt-GetComObjectList 

2 jCmdResult = GetScriptList 

3 ICmdResult - GetObjectinfo(CmdStr) 

4 |CmdResult - IsInRepository(CmdStr) 



5 



Res = IsAssigned(CnidStr,Owner,OwnerId) 
CmdResalt = VarArrayOn;[Res,Owner,OwnerId]) 



What's New with MetiLinx iManager Developer 2.2 



MetiUnx Enterprise 2.1 has branched out to MetiLinx iManager Developer 2.2 (iManager) and MetiLinx iSystem Enterprise 2,2 
(iSystem). iManager is a development tool that aids developers in building e-business systems. These systems subsequently inherit 
the MetiUnx optimization technology. This release of iManager delivers a broad range of object support and management in an open 
environment 



^ Dual interface support for scripting languages 

MetiUnx iManager Developer 2.2 supports the IDispatch interface to enable developers working in 
scripting languages, such as VBScript and JScript to access the iManager Repository components. 

S New! Script Editor 

The new Script Editor offers basic editing support, enabling developers to edit code from generic and 
marshalling scripts. 

S Enhanced remote COM management 

With MetiUnx iManager Developer 2.2, MetiUnx continues to build and expand upon the remote COM 
management functionality and open environment of MetiUnx Enterprise 2.1 Enhanced features include: 

• Improved object streaming 

o Enables remote object handling without the need to register the client 

o Promotes code efficiency 

o Supports local and remote calling on client 

• Object repository management 

• Access to host-level information, such as, connection objects, repository objects, and user 
connectors. 



Script Messages 



Marshalling script actions are identified by Command ID numbers. Duplication of these ID numbers can occur within other scripts 
and objects, and are often associated to different actions. To manage such duplication among scripts, i Manager provides an system 
of identification that allows developers to assign unique message IDs to script actions, while maintaining the development team's 
proprietary or legacy numbering system. 



Message ID Number (DWORD) associated to an alert 

definition. 

Command ID Unique identifier (DWORD) of a command. 

ImUserMsgID A hexkletimai constant (0x80000001) added to 

the Message ID to create a unique hexkjeciarnl 
number that maps to the Command ID. 



How the message mapping works 

Given: 

Message ID =3 
Command ID =6 

Result: 

ImUserMsgID (0x80000001 ) + Message ID (3) = (0x300X30004) and maps to Command ID 6 for the script 



To map command IDs 

1 . Select the object you want to add a message ID to in Scripts, located under Business Rules Objects. 

2. Click Action | Script Messages. 



iManager opens the Messages dialog box. 




3. Click Add. 
iManager opens the Add/Modify Message dialog box. 



What's New with MetiLinx (Manager Developer 2.2 



MetiLinx Enterprise 2.1 has branched out to MetiLinx Manager Developer 2.2 (iManager) and MetiLinx iSystem Enterprise 2.2 
(iSystem). iManager is a development tool that aids developers in building e-business systems. These systems subsequently inherit 
the MetiLinx optimization technology. This release of iManager delivers a broad range of object support and management in an open 
environment. 



S Dual interface support for scripting languages 

MetiUnx iManager Developer 2.2 supports the IDispatch interface to enable developers working in 
scripting languages, such as VBScript and JScript, to access the iManager Repository components. 

V New! Script Editor 

The new Script Editor offers basic editing s upport, enabling, developers to edit code from generic and 
marshalling scripts. 

S Enhanced remote COM management 

With MetiUnx iManager Developer 2.2, MetiLinx continues to build and expand upon the remote COM 
management functionality and open environment of MetiLinx Enterprise 2. 1 . Enhanced features include: 

• Improved object streaming 

o Enables remote object handling without the need to register the client 

o Promotes code efficiency 

o Supports local and remote calling on client 

• Object repository management 

• Access to host-level information, such as, connection objects, repository objects, and user 
connections. 



Select an Object from Object Repository 



Select an object to add to the marshalling script 

Object Name Use this metaname in the marshalling script code 

to refer to an instance of this object. 




Configuring iManager: Select iManager Administrative Database 



The iManager Developer 2.2 (iManager) installation process includes configuring the administrative database that supports 
iManager. This database maintains all information regarding the hosts, connection objects, COM objects, scripts, and users. 
iManager currently supports SQL Server 7 and Oracle 8i for the administrative database. 



Select User ID 



To add user access to a connection, select a user ID. 



Users from Host <host> List of user IDs available for selection. If none 

appear, than none are available. Consider adding 
additional host user IDs from the global users. 

Selected User ID The ID selected from the list Click OK to enter 

user authentication information for database 
access. 



Select Users for this Host 



Import selected 

Invert selection 

Select AH 
Deselect All 



Click this button to import the IDs manually 
selected. 

Click this button to deselect the manually selected 
IDs. 

Click this button to select all the IDs listed. 
Click this button to deselect all the selected IDs. 



Select users for this host 
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Select Users/Groups of this External Source 



1. Click Groups or Users in the list on the left pane. 

2. Check the Users or Groups you want like to import in to iMai^er. 

3. Qidc Import selected to proceed with the import process. 

ff errors occur during the importing process, check the USERS.LOG, located in the MetiLinx Enterprise 2.2 directory, for error 
descriptions. 

4. When the import process is complete, click Close. 



Note 



Imported User IDs and passwords are not modifiabte in iManager. You can, however, change the User Name and assign 
administrator rights to User IDs. All options are available in the Proprietary users dialog box. 



Import selected 

Invert selection 

Select All 
Deselect All 



Click this button to import the IDs manually 
selected. 

Click this button to deselect the manually selected 
IDs. 

Click mis button to select all the IDs listed. 
Click mis button to deselect all the selected IDs. 



Select users/groups of this external source. [SQLServer] 




Sending Messages to a Host 



procedure Execute { var MsglD 

var Command 
var Res 



: OleVariant; 

: OleVariant; 

: OleVariant }; safecall 



// The message identifier that is to be 
sent 

//Contains the command data 

//Returns the result data as an OLE 
object Res = TRUE, Execute 
successful, Res = FALSE otherwise. 

Description: Function used for executing SQL command that does not return a result set. 



procedure GetData (const : OleVariant; //Contains the command data 

Command 

var data : OleVariant; //Returns the result data as an OLE 

object 

Status : OleVariant ); safecall //Status = 0, if GetData successful. 

Status o 0 otherwise 

Description: Use GetData to access one or more tables in a data store using SQL statements, retrieve data from 
tables in data store using SELECT statements. 



Sending Messages to a Host 



function SendMsg ( var 
MsglD 



ClienttD 



: Longint; 



: Longint; 



//Returns imDone (0), If action 
was successfully executed. 
Otherwise, error message ids 
are returned. 

//Client the message is sent from 



var Msg : PChar ) :WordBod;stdcall;export; //Returns the result data in string 

format. Records are separated 
by CRUF and fields are 
separated by TAB character. 

Description: This function sends and receives messages between the client and the Host. It does not return a result until an answer 
message is received or the message has timed-out 

After a call to this function, the client will wait for the Host to perform the requested action and then return a result. 
Actions, like updates, that do not require an explicit answer will receive a payioad describing the number of rows 
affected by the operation. 

Returns: If message ts sent and an answer is received it returns TRUE, otherwise it returns FALSE. 



Example in PASCAL 

BufferStr := 'Select GetDateO'; 

StrPCopyt Buffer , BufferStr ); 

MsglD:=imGetSQUnfo; 

If SendMsg (MsglD, ClientlD, Buffer) men 

CurrentDT := StrTcOateTirn^CopytBuffer^ , Pos(#9,Buffer) -1)); 

The above example returns the date and time value on the server. 



function SendMsgB 



(var 
MsglD 



var 

ClientJD 
var Msg 



varSize 



: Longint; 



: Longint; 



: PChar: 



: Longint ) :WordBool;stdcall;export; 



//Returns imDone (0), rf action 
was successfully executed. 
Otherwise, error message ids 
are returned. 

// Client the message is sent 
from 

//Returns the result data in 
binary format 

//Returns the size of the data 
returned 



Description: This function sends and receives messages between the client and the Host The host returns data in binary format. 
This is useful when sending and receiving a blob or image field- It does not return until an answer message is 
received or the message has timeckxit 

Returns: If message is sent and an answer is received it returns TRUE, otherwise it returns FALSE. 

Example in PASCAL 

BufferStr := 'Select BMP From Animals Where Name = "Boa**'; 

StrPCopy( Buffer , BufferStr ); 

Size:= StrLen(Buffer); 

MsglO:=imGetBinary1nfo; 

SendMsgB(MsglD , ClientJD , Buffer Size); 



The above example will get a blob field from the table "Animate". 



function SendMsgOLE ( var MsglD : LongWord; 



//Returns imDone (0), 



varClientlD 
varMsg 



var 



if action was 
successfully 
executed. Otherwise, 
error message ids are 
returned. 

LongWord; // Client the message 

is sent from 

WideString; //Returns the result 

data. 



: OLEVariant ) :WordBool;stdcaJI;export; //Returns data as OLE 
OLEResult object 

Description: This function sends and receives messages between client and host The host returns data in Variant format (like 
Recordsets). 

Returns: If message is sent and an answer is received it returns TRUE, otherwise it returns FALSE. 
Example in PASCAL 

BufferStr := 'Select * From Animals Where Name = "Boa"'; 
I^ID:=arK3etOLEData; 

SendMsgB{MsglD , CiientlD , Buffer ,VarResuft); 

The above example retrieves a record from the table "Animals" in the form of a Recordset object- 



Setup Files 



To download MetiLinx iManager Developer Z2 from the MetiLinx Web site, you must register and agree to the License Terms of the 
Software License Agreement MetiLinx, Inc. grants. Download the file, Me tiia.nxEnterprise2 . 2 . exe, to the Download directory. 

Tip: 

Be sure to carefully read the License Terms of the Software License Agreement MetiLinx, Inc. grants the following licenses for 
the use of MetiUnx iManager Developer 2.2: 

• 30-Day Evaluation 

• Development 

• Enterprise 

Evaluation use of the software begins upon downloading the software and precisely ends 30 days, thereafter. 



Server Software Requirements 



• Windows® 2000 Server or Windows 2000 Advanced Server 

• Windows NT Server 4.0 or Windows NT Server 4.0 Enterprise Edition 
1 Service Pack 6 

2. Windows NT 4.0 Option Pack 

• Active Directory Service Interfaces (ADSI) {Included with Windows 2000) 

• Windows NT Workstation 4.0 (recornrnended for only evaluation purposes) 

• LDAP (Lightweight Directory Access Protocol) 2.0 

• Microsoft SQL Server™ 7.0 

• OracteS® 

• Or any OLE DB or ODBC-cornpiiant database management system 



Using SQL Server 7 



If you are using SQL Server 7 as your Database Management System (DBMS), then follow these instructions to create the iManager 
administrative database. 

To create the administrative database 

1 At the iManager Developer 2.2 Configuration window, select Microsoft SQL Server, then click Next 

2. Click Edit Connection String to create the ADO connection string. 

3. Click the Provider tab, and select Microsoft OLE DB Provider for SQL Server. 

4. Click Next 

5. Cfickthe Connection tab, and select or enter a name in the Server Name box. 

a Enter a Username (typically, SA) and Password. (Verify the type of security SQL Server uses— Windows NT Only 
(Integrated) or SQL Server aid NT.) 

7. Click OK then click OK, again, at the Create Connection Object window. 
Note: 

DorK3tcorr^eStep3oftheConnectkxitab. If you do, you will receive error messages because the administrative database 
does not yet exist 

i 

8. Click OK to test the connection object. 

9. Enter the Username and Password you previously indicated. 

1 0. Select the Create New User check box to create a separate administrative account to administrate the iManager database. 

11. Enter a Username and Password, confirm the password, and thai click Next 

12. Enter a Name, for example, MetiLinx, for the new iManager administrative database. 

13. Click Run AH to create the database. 

Once the installation process builds the administrative database, ft is complete. 
Note: 

Do not edit the connection string. The only time the connection string is altered, is when you reinstall the application. When you 
do, a new database overwrites the previous administrative database. 



Verifying a Script 



iManager's script editor enables developers to verify script code. 

1 Select the script want to verify. 
2. Click Action J Verify Script 



: n 7. 
is-- 



(Manager opens the Look at in Windows Registry dialog box. 



Look at in Windows Registry 




O 



3. The script is immediately checked and a report displayed. 



Verifying a User Logon 



Administrators can verify a user ID logon from within either the Host Users folder or the Users folder. 

To verify a user logon 

1. Click the Host or Host Users folder. 

2. In the right pane, right-click the user ID; then dick Verify Logon. 

3. Type the corresponding parameters for each box 

Note: 

You can view the user ID Source Name from the Users folder by expanding the iManager window. 



Viewing all Scripts 



To clear the fitters and view aii the scripts 

1. Click Scripts located in Object Repository > Business Rules Objects. 
2 Click Action | View all the scripts. 

The display filters change dyriamtcally. 
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Viewing all the COM Objects 



To clear the filters and view all the COM objects 

1. Click COM Objects located in Object Repository > Business Rules Objects. 

2. Click on Action | View ail the COM objects. 



The display fitters change dynamically. 



Viewing Objects 



To Filter Objects 

1 . Click COM Objects located in Object Repository > Business Rules Objects. 

2. Click Action | Fitter Objects. 



{'Manager opens the Searching window. 




3. Select or type a Field to narrow your search. 



If your search is unsuccessful, the "No object matches your query" message appears and the display does change. Otherwise, me 
display filters change dynamically. 



Using SQL Server 7 



If you are using SQL Server 7 as your Database Management System (DBMS), then follow these instructions to create the iManager 
administrative database. 

To create the administrative database 

1 . At the iManager Developer 2.2 Configuration window, select Microsoft SQL Server, then click Next 

2. Click Edit Connection String to create the ADO connection string. 

3. Click the Provider tab, and select Microsoft OLE DB Provider for SQL Server. 

4. Click Next 

5. Click the Connection tab, and select or enter a name in the Server Name box 

6. Enter a Usemame (typically, SA) and Password. (Verify the type of security SQL Server uses— Windows NT Only 
(Integrated) or SQL Server and NT.) 

7. Click OK then click OK, again, at the Create Connection Object window, 
note. 

Do not complete Step 3 of the Connection tab. If you do, you will receive error messages because the administrative database 
does not yet exist 

8. Click OK to test the connection object 

9. Enter the Usemame and Password you previously indicated. 

1 0. Select the Create New User check box to create a separate administrative account to administrate the iManager database. 

1 1 . Enter a Usemame and Password, confirm the password, and then click Next 

12. Enter a Name, for example, MetiLinx, for the new iManager administrative database. 

13. Click Run All to create the database. 

Once the installation process builds the administrative database, it is complete. 
Note: 

Do not edit the connection string. The only time the connection string is altered, is when you reinstall the application. When you 
do, a new database overwrites the previous administrative database. 



To Uninstall MetiLinx iManager Developer 2.2 



1 . On the Start menu, point to Settings, and then select Control Panel. 

2. Double-click on the Add/Remove Programs icon. 

3. Click the Install/Uninstali tab. 

4. From the list of programs mat Windows can remove, select IManager 2.2. 

5. Click Add/Remove. 

6. At the prompt, click Yes to confirm that you want to remove the MetiLinx Enterprise 2.2 program. 
Note: 

You may safety respond Yes to All when the uninstall program prompts you to confirm the removal of the following files located in 
C:\ProgramFiles\Common \MefiUnx\MeaLinx Enterprise 2.2: 

Procdatadll 

Sysdatadll ( 

MetilinxCftjectdll 

Msscriptocx 

QueryObjectexe 



The Script Editor 



One of the new enhancements to MetiLinx iManager Developer 2.2 is the Script Editor, a simple solution for editing script code. Use 
Script Editor much like other scripting editors. Below is a brief outline of basic instructions. 

To open a file 

1/ On the File menu, click Open File. 

2. if you want to open a document that was saved in a different folder, locate and open the folder. 

3. Select the document you want to open and click Open. 

To save a file 

• On the File menu, click Save File. 
To save a file as 

1 . On the File menu, click Save File As. 

2. If you want to save the document in a different folder, locate and open the foWer. 

3. In the File name box, type a name for the document 

4. Click Save. 

To verily the script code 

1. On the File menu, click Verify Script 

2. If the script code has syntax error, they are shown in a window of report 
To print a file 

1. On the File menu, click Print 

2. Set the printing options you want 

3. Click OK. 

To setup the printer 

1 On the File menu, click Printer Setup. 

2. Set the printer options you want 

3. Click OK. 

To delete, cut, copy, and paste text 

• To delete characters to the left of the insertion point, press the BACKSPACE key. 

• To delete characters to the right of the insertion point, press the DELETE key. 

• To delete words, select them, and ten press the BACKSPACE or DELETE key. 

• To cut text so you can move it to another location, select the text Then, on the Edit menu, dick Cut. 

• To copy text so you can paste a copy of it in another location, select the text Then, on the Edit menu, click Copy . 

• To paste text you have cut or copied, place the insertion point where you want to paste the text. Then, on the Edit menu, dick 
Paste. 

To wrap text to the window size 

• On the Character menu, dick Word Wrap. 

Note: 

Wrapping text enables you to see all me text m 



To find specific characters or words 

1 . On the Tool menu, click Find Text 

2. In the Find What box, type the characters or words you want to find. 

3. Click Find Next. 



Adding Users to iManager 



1 . Right-dick Hosts, then click Add New User/Proprietary. 

2. Type a User Name, User ID, Password, and Password Confirmation. 

3. (Optional) Check the Administrator box. 



User Name 
User ID 

Password 

Password Confirmation 
Administrator 



An optional descriptive name of the user that can be 
the same as the User ID. 

Required user login ID (20 
ch^acter-alpha-numeric- maximum, first character 
must be a letter). 

User ID password (20 character--aJpha-nunieric- 
maximum, first character must be a letter). 

Confirmation of User ID password. 

Select to give User ID administrative rights to 
manage iManager. iManager logon is restricted to 
administrators. 



To Create the Oracle Database Using Mkoradb.exe 



1. Open a command prompt at the database server 

2. Type c: or the drive letter where you installed iManager. 

3. Type cd program fiies\metilinx\nietilinx enterprise 2.2 or the directory path where you installed iManager. 

4. Type mkoradb DB1D DBNAME password to run the batch file where the parameters represent me following usage: 

• DBID A four^&aracter database system identifier (SID) (4 character limit) 

• DBNAME The name of the database being created (8 character limit) 

• password The password for the Internal (or the first user) of the database. This user is granted super 
user rights 

5 To test the connection, type vaw interoal/password@dfoname at the command prompt 

Once the database constructor builds the administrative database and you have tested the con Rectal, you may continue with 
configuring iManager. 

Tip: 

Use MTLX as the system (source) identifier and METIUNX as the database name. 



To import Users from an External Source 



1 . Right-click Hosts, then dick Add New User/External Source. 

2. Type the corresponding information in each box. Follow the guidelines below. 

3. Click Retrieve. 

If your selections are accurate, iManager opens the Select users/groups of this external source dialog box. 

4. Click Groups or Users in the list on the left pane. 

5. Check the Users or Groups you want like to import in to iManager. 

6. Click Import selected to proceed with the import process. 

If errors occur during the importing process, check the USERS.LOG, located in the MetiUnx Enterprise 2.2 directory, for error 
descriptions. 

7. When the import process is complete, click Close. 




Source The location from which the collection of user and 

user group information is taken. Enter the 
following source inforrnation based on the Source 
Kind: 

SQLServer server name 

WinNT NT domain name 

Oracle service name 

LDAP server IP address 

Source Kind A code representation of the source program. 

Valid source kinds include* 

WinNT (Windows NT Domain) 

SQL Server and Oracle (Database Server) 

LDAP (Server). 

When the source kind is selected, the iManager 
automatically generates a new source name 
identifier. This identifier is modifiable. 



Source Name 



Administrator ID 
Password 

Database/Directory Name 



Provider 



A unique identifier for a source. The same as the 
Source ID that is part of a user's authentication 
credentials. 

Select New to create a new source name. 
iManager verifies that the name is unique. Do not 
check New if you want to use an existing source 
name. 

The user ID that has administrative authority to 
access the source. 

The password for the administrator ID.. 

tf necessary, depending on the kind of external 
source, specify a database name (for database 
servers) or a directory to from which to retrieve 
users and user groups information. 

Select the corresponding database access 
provider or type a connection string. 



Tip: 

Specify only the corresponding source information indicated below: 



Windows NT 



LDAP 



SQLServer 



Source: Domain name or IP address 

Source Kind: WinNT 

Source Name: A unique identifier 

Source: IP address of the LDAP server 

Source Kind: LDAP 

Source Name: A unique identifier 

Source: IP address of the SQL server 

Source Kind: SQLServer 

Source Name: A unique identifier 

Administrator ID: Sysadmin (sa) or an equivalent 
administrator login. Verify type 
of SQL server security. 

Database: Name of the d^absse from which the 
users and user groups are 
being taken. 

Provider SGLOLEDB. 1 , the current Microsoft 
OLE DB provider for SQL 
Server. Otherwise, use 
MSDASQL1 , the Microsoft 
OLE DB provider for ODBC 



Oracle Source: The Oracle service name (Servername) 

Source Kind: Oracle 

Source Name: A unique identifier 

Administrator ID: Use Internal or an equivalent 
administrator login. 

Provider MSDAORA, 1 for the Microsoft OLE 
DB provider for Oracle 




Import selected Click this button to import the IDs manually 

selected. 

Invert selection Click this button to deselect the manually selected 

IDs. 

Select All Click this button to select all the IDs listed. 

Deselect All Click mis button to deselect all the selected IDs. 



Note: 

Imported User IDs and passwords are not modifiable in iManager. You can, however, change the User Name and assign 
administrator rights to User IDs. All options are available in the Proprietary users dialog box. 



To Modify a User in iManager 



1. In the Hosts detail pane, right-dick the User ID you want to modify, then click Modify User. 

2. Type a User Name, User ID, Password, and Password Confirmation. 

Source Name The Source ID located in the Host detail panel. 

User ID User login ID. 

Password Password of User ID (20 

character-aJpha-numeric- maximum, first 
character must be a letter). 

Administrator Select to give User ID administrative rights to 

manage iManager. iManager logon is restricted to 
administrators. 



To Remove Users from {Manager 



All User IDs that are deleted from Users (located under MetiUnx Root) are permanently deleted from (Manager. These IDs are 
automatically removed from Host Users. 



To permanently remove a User ID from iManager 
1 In Users, right-dick the User ID you want to remove, and then Delete User. 



The {Manager Message confirmation below appears. 




2. Click OK to proceed with the deletion. 
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To Verify a User's Logon 



1 In the detail pane! of Users, right-click the User 10 you want to verify, and then click Verify Logon. 
2. Type the Source Name . User ID, and Password. 

Note: 

View the Source Name (Source ID) in the Hosts detail pane. iManager does not display the Password. Passwords of imported 
User IDs cannot be changed in (Manager. 



User DB Access 



User ID 

User Authentication for DB 
Access 



Usemame and Password 
for DB Access 



Same User login ID selected from host 

Select Self to use the same user ID and 
password used for iManager authentication. The 
host connection object detail pane identifies the 
specified user ID security as Self. 

Select Defi ne to identify a separate usemame and 
password fa database access. The host 
connection object detail pane identifies the 
specified user ID security as Yes. 




User DB Access 



User DB Access with authentication defined 



Update Messages 



J ID 

Message Number 
Explanation 



imSQLUpdate 
$00000201 

This message is used to perform standard SQL update queries like INSERT, DELETE and 
UPDATE. 



Required Paytoad 

Paytoad Return 

Code Example 
(PASCAL) 



Result 

Function Word 



The standard query statement for the update to a database. 
Number of rows affected. 

Buffer := 'Use UserDB Delete Userlnfo Where RecordJD = 2*; 

MsglD:=imSQLUpdate; 

SendMsg (MsglD, CfientlD, Buffer); 

The above example deletes the record number 2 from the Userlnfo table in the UserDB database. 
SendMsg 



User Messages 



ilD 

Message Number 
Explanation 



imUserMsg 
$80000001 

This is the low bound delimiting iManager proprietary messages from user defined messages. 
User defined messages start at imUserMsg + 1, User defined messages are always sent using 
SendMsgOLE. At the host, these messages will be redirected to the broker for Business Rule 
Objects (BRO) instead of the database server. MsglDs are associated with BROs within 



Required Paytoad 
Payioad Return 

Code Example 
(PASCAL) 



The request to be sent to the corresponding BRO as a wide string. 
The resulting data as a Variant. 
ftfeglD;=^JserMsg + 1; 
WString:='SELECT E22:F25'; 
SeiidMsgOLE(nfeglO i aientlD l wS&ingyarResult); 



Resu it Data returned by the BRO after executing the command sent using its ProcessCommand interface 

function. 

Function Word SendMsgOLE 



The Userlnfo Interface 



This object implements an interface called lUserlnfo containing the method: 

HRESULT _stdcail GetUserListffin] BSTR Hostname, [out, retvaq VARIANT * UserList ); 

Using this method, callers can get the list of users currently connected to a given host (described by Hostname). The list is returned 
in UserList and has the following structure: 

♦ UserList is a one-dimensional zero-based varArray containing as many positions as users are currently connected to the 
host. 

♦ Each position is again a one-dimenskxial zero-based varArray (UserOesc) with 5 positions defined as follows: 

UserDescfO]: Contains the Usedd as WkteString. 

UserDesc[1]: Contains the CKentIO assigned to this user at connection time. 

UsenDescg]: Contains the Connectionld assigned to this connection. 

UserDesc{3]: Contains the client IP-Address as WkteString. 

UserDescf4j: Contains date and time of connection establishment as WindeString. 

• In case the host is not running, UserList returns NULL 

• If the host is running, but no users are connected, UserList returns Unasslgned. 



The IMetiLinx implementation for this object translates Cmdid « 1 into a calf to GetUserList, using CmdStr as Hostname and 
CmdResult as UserList For other values of CmdID the object returns -20007 (error in parameters). 



Using Oracle 81 



If you are using Oracle & as your DBMS, then follow these instructions to create the iManager administrative database- 
Configuring (Manager to use an Oracle database requires running the iManager Oracle Database Constructor (Mkoradb . exe) 
the database server to simplify me database creation process. The batch fife completes the following processes on the Oracle 
database server 

• Creates and starts an Oracle instance 

• Creates a database associated with the instance 

• Adds the database to the listener file so it can accept client connections 

• Configures the client connection 

Additional Topic: 

To Create the Oracle Database using Mkoradb.exe 



Member Descriptor 



A member descriptor is a five-element array of variant that describes a member (function or property) of an object, including 
parameters and result, if needed. Use it to specify member calls and marshal results when remotely invoking. 



Mem berDescriptor: Variant containing a one dimensional array of Variant with 5 elements where: 



MernberDescriptor {0] : Name of the interface the member belongs to. If the member name is a nested 

reference using dot notation, this element refers to the interface containing the first 
property from the left 



MernberDescriptor {1] 
MernberDescriptor [2]: Flags desoibing the invocation context as follows: 



Name of the member to invoke. Nested references to members (using dot notation) 
allowed. 



FLAG NAME 

INVOKE_FUNC 
INVOKE_PROPERTYGET 
INVOKE^PROPERTYPUT 
INVOKE PROPERTYPUTREF 



FLAG 
VALUE 

1 

2 
4 
8 



DESCRIPTION 

The member is invoked as a 
method. 

The rnember is retrieved as 
a property or data member 

The rnember is set as a 
property or data member 

The member is set by a 
reference assignment, 
rather than a value 
assignment. This flag is 
valid only when the property 
accepts a reference to an 
object 



MernberDescriptor [3] : ParamLst, one dimensional array of Variant with 4 elements describing the parameter 
fist 

ParamLstfOJ : Number of parameters the member takes. 
ParamLst[1]: Nurnerr^naried parameters 

ParamLstg] : VarArray with as many elements as parameters the member takes. 

Parameter matching is made from left to right Values for input 
parameters must be set prior invocation. Type matching between array 
elements and parameters is responsibility of the caller. 

ParamLst[3]: Array of named parameters. See examples of how to define the 
Parameter List. 



MernberDescriptor [4] : Variant where the result is marshaled back to the caller, or NULL if the caller expects 
no result. This argument is ignored if INVOKE J>ROPERTYPUT or 
INVOKE J>ROPERTYPUTREF is specified. 



Member Descriptor 



A member descriptor is a five-element array of variant that describes a member (function or property) of an object, including 
parameters and result, if needed. Use it to specify member calls and marshal results when remotely invoking. 

Member Descriptor Variant containing a one dimensional array of Variant with 5 elements where: 



MemberOescriptorfO] : 

MemberDescriptor [1] : 
MemberDescriptor [2] : 



Name of the interface the member belongs to. If the member name is a nested 
reference using dot notation, this element refers to the interface containing the first 
property from the left 

Name of the member to invoke. Nested references to members (using dot notation) 
allowed. 

Rags describing the invocation context as follows: 



FLAG NAME 
INVOKE _FUNC 
INVOKEJPROPERTYGET 
INVOKE J'ROPERTYPUT 
INVOKE PROPERTYPUTREF 



FLAG 
VALUE 

1 

2 
4 
8 



DESCRIPTION 

The member is invoked as a 
method. 

The member is retrieved as 
a property or data member 

The member is set as a 
property or data member 

The member is set by a 
reference assignment, 
rather than a value 
assignment This flag is 
valid only when the property 
accepts a reference to an 
object 



MernberDescriptor [3] : 



ParamLst, one dimensional array of Variant with 4 elements describing the parameter 
list 

ParamLsttO]: Number of parameters the member takes. 
ParamLst[1] : Numer of named parameters 

ParamLst[2]: VarArray with as many elements as parameters the member takes. 

Parameter matching is made from left to right. Values for input 
parameters must be set prior invocation. Type matching between array 
elements and parameters is responsibility of the caller. 

ParamLst[3]: Array of named parameters. See examples of how to define the 
Parameter List. 



MemberDescriptor [4] : 



Variant where the result is marshaled back to the caller, or NULL if the caller expects 
no result This argument is ignored if INVOKE_PROPERTYPUT or 
INVOKE_PROPERTYPUTREF is specified. 



Member Descriptor 



A member descriptor is a five-element array of variant that describes a member (function or property) of an object, including 
parameters and result, if needed. Use it to specify member calls and marshal results when remotely invoking. 



Member Descriptor: Variant containing a one dimensional array of Variant with 5 elements where: 



MemberDescriptor [0] : 

MemberDescriptor [1] : 
MemberDescriptor [2] : 

FLAG NAME 

INVOKE_FUNC 
INVOKE_PROPERTYGET 
INVOKE_PROPER7YPUT 
INVOKE PROPERTYPUTREF 



Name of the interface the member belongs to. If the member name is a nested 
reference using dot notation, this element refers to the interface containing the first 
property from the left 

Name of the member to invoke Nested references to members (using dot notation) 
allowed. 

Rags describing the invocation context as follows: 



FLAG 
VALUE 

1 
2 
4 
8 



DESCRIPTION 

The member is invoked as a 
method. 

The member is retrieved as 
a property or data member 

The member is set as a 
property or data member 

The member is set by a 
reference assignment, 
rather than a value 
assignment This flag is 
valid only when the property 
accepts a reference to an 
object 



MerrtoerDescriptor [3] : ParamLst, one dimensional array of Variant with 4 elements describing the parameter 
list 

ParamLstfO] : Number of parameters the member takes. 
ParamLstfl]: Numerof named parameters 

ParamLst[2]: VarArray with as many elements as parameters the rnernber takes. 
Parameter matching is made from left to right Values for input 
parameters must be set prior invocation. Type matching between array 
elements and parameters is responsibility of the caller. 

ParamLst[3]: Array of named parameters. See examples of how to define the 
Parameter List. 



MemberDescriptor [4] : Variant where the result is marshaled back to the caller, or NULL if the caller expects 
no result This argument is ignored if INVOKE_PROPERTYPUT or 
INVOKE J^OPERTYPUTREF is specified. 



Verify Password 



Password 



Confirm User Name password for database 



Verify Password 



Verifying a COM Object 



iManager enables developers to test COM objects for errors. 

1. Seiectthe COM Object you want to verify. 

2. Click Action | Verity Object. 



iManager opens the Look at in Windows Registry Window. 




I ll The object is irmiediateiyche<*edand^ 



Viewing Scripts 



To Filter Scripts 

1 . Click Scripts located in Object Repository > Business Rules Objects. 

2. Click Action | Filter Scripts. 

i Manager opens the Searching dialog box. 




3. Select or type a Field to narrow your search. 



If your search is unsuccessful, the "No object matches your query" message appears and the display does change. Otherwise, the 
display filters change dynamically. 



Welcome 



Welcome to MetiLinx (Manager Developer 2.2 and MetiLinx™ technology— Making the Internet Powerful!™ 

MetiLinx digital technology tools male the Internet a more powerful place to do business, by delivering speed flexibility stability 
dependability, and optimization to commercial, web-based systems. 

Look for new things to come from MetiLinx as we continue to expand our fine of optimization and development enhancement 
products. Please visit our Web site at www metilinx.com . 
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